rails_simple_event_sourcing 1.0.8 → 1.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3de0a8a9ff2169679636b2f07ecbeb3c665bfd6a7167f564029c343d508dbcc0
-  data.tar.gz: 136e1bb962428462dd0921cefa63746beefb6efab578f6c8a0e018709f10da1f
+  metadata.gz: 2cdc3924ccf5cb03de4c576e06e36516187ab5743fdeacb7c4b543e1733af6ed
+  data.tar.gz: e8a6bcce2a7b918a9a55ffd37dcf11e31c4692c53678ae083a59213fdd39e29e
 SHA512:
-  metadata.gz: fcd653bc3201aeb4cffca05df6f9819e3b8d9ee2eab08e60e35988438321bf6f6b15fb7d65d0940483f9087877f5f451645fc26f7e1fb31fb36e61a898760aee
-  data.tar.gz: 85449f552f258d5d2ccd43f238389769dafdf885d93beeb7f1e4f47280f1bbc9ab5acb8fa435e94a3ca9f0602af52677812f1c8dcffa85857277b977081f0fb7
+  metadata.gz: 2825950884885d9366e2586ddada26b272fc9551ba92caefe9be08c78569ad5df7243bef7b6fcf51f3e6529fc93dba1b455aacb7e7ed61b94ce9c40bd9ac0868
+  data.tar.gz: b8b2ec4ceca8ace0ec9f51185ac373008c73a11c0aa536d650d844464822c2e4bf6aa919d797aff36807ceca23f366ebbadaf94dcd78230b0ace007d0efd33c6

data/README.md

@@ -173,15 +173,45 @@ Handlers can be discovered in two ways:
 2. **Convention-based** - Using naming convention mapping (can be disabled via configuration)
 
 **Result Object:**
-The `Result` struct has three fields:
+The `Result` class has three fields:
 - `success?` - Boolean indicating if the operation succeeded
 - `data` - Data to return (usually the aggregate/model instance)
 - `errors` - Array or hash of error messages when `success?` is false
 
-**Helper Methods:**
-The base class provides convenience methods:
-- `success_result(data:)` - Creates a successful result
-- `failure_result(errors:)` - Creates a failed result
+Use the factory methods to build results:
+
+```ruby
+# Successful result
+RailsSimpleEventSourcing::Result.success(data: customer)
+
+# Failed result
+RailsSimpleEventSourcing::Result.failure(errors: { email: ["already taken"] })
+```
+
+It supports a chainable API for use in controllers:
+- `on_success { |data| }` - Executes the block (yielding `data`) if the result is successful
+- `on_failure { |errors| }` - Executes the block (yielding `errors`) if the result failed
+
+Both methods return `self`, so they can be chained. The predicate `success?` remains available for use in conditionals and tests.
+
+```ruby
+result = RailsSimpleEventSourcing::Result.success(data: customer)
+
+# Chainable (preferred in controllers)
+result
+  .on_success { |data| render json: data }
+  .on_failure { |errors| render json: { errors: }, status: :unprocessable_entity }
+
+# Predicate (preferred in tests)
+result.success? # => true
+result.data     # => #<Customer ...>
+result.errors   # => nil
+```
+
+**Helper Methods in Handlers:**
+Inside a command handler, `success` and `failure` are delegated to `RailsSimpleEventSourcing::Result`:
+- `success(data:)` - delegates to `RailsSimpleEventSourcing::Result.success`
+- `failure(errors:)` - delegates to `RailsSimpleEventSourcing::Result.failure`
 
 **Example - Basic Handler:**
 
@@ -198,11 +228,7 @@ class Customer
           updated_at: Time.zone.now
         )
 
-        # Using helper method (recommended)
-        success_result(data: event.aggregate)
-
-        # Or create Result directly
-        # RailsSimpleEventSourcing::Result.new(success?: true, data: event.aggregate)
+        success(data: event.aggregate)
       end
     end
   end
@@ -224,11 +250,11 @@ class Customer
           updated_at: Time.zone.now
         )
 
-        success_result(data: event.aggregate)
+        success(data: event.aggregate)
       rescue ActiveRecord::RecordNotUnique
-        failure_result(errors: ["Email has already been taken"])
+        failure(errors: ["Email has already been taken"])
       rescue StandardError => e
-        failure_result(errors: ["An error occurred: #{e.message}"])
+        failure(errors: ["An error occurred: #{e.message}"])
       end
     end
   end
@@ -358,13 +384,10 @@ class CustomersController < ApplicationController
       last_name: params[:last_name],
       email: params[:email]
     )
-    handler = RailsSimpleEventSourcing::CommandHandler.new(cmd).call
 
-    if handler.success?
-      render json: handler.data
-    else
-      render json: { errors: handler.errors }, status: :unprocessable_entity
-    end
+    RailsSimpleEventSourcing::CommandHandler.new(cmd).call
+      .on_success { |data| render json: data }
+      .on_failure { |errors| render json: { errors: }, status: :unprocessable_entity }
   end
 end
 ```
@@ -382,13 +405,10 @@ class CustomersController < ApplicationController
       last_name: params[:last_name],
       email: params[:email]
     )
-    handler = RailsSimpleEventSourcing::CommandHandler.new(cmd).call
 
-    if handler.success?
-      render json: handler.data
-    else
-      render json: { errors: handler.errors }, status: :unprocessable_entity
-    end
+    RailsSimpleEventSourcing::CommandHandler.new(cmd).call
+      .on_success { |data| render json: data }
+      .on_failure { |errors| render json: { errors: }, status: :unprocessable_entity }
   end
 end
 ```
@@ -399,13 +419,10 @@ end
 class CustomersController < ApplicationController
   def destroy
     cmd = Customer::Commands::Delete.new(aggregate_id: params[:id])
-    handler = RailsSimpleEventSourcing::CommandHandler.new(cmd).call
 
-    if handler.success?
-      head :no_content
-    else
-      render json: { errors: handler.errors }, status: :unprocessable_entity
-    end
+    RailsSimpleEventSourcing::CommandHandler.new(cmd).call
+      .on_success { head :no_content }
+      .on_failure { |errors| render json: { errors: }, status: :unprocessable_entity }
   end
 end
 ```

data/lib/rails_simple_event_sourcing/command_handler.rb

@@ -9,7 +9,7 @@ module RailsSimpleEventSourcing
     end
 
     def call
-      return Result.new(success?: false, errors: @command.errors) unless @command.valid?
+      return Result.failure(errors: @command.errors) unless @command.valid?
 
       initialize_command_handler.call
     end

data/lib/rails_simple_event_sourcing/command_handlers/base.rb

@@ -3,20 +3,14 @@
 module RailsSimpleEventSourcing
   module CommandHandlers
     class Base
+      delegate :success, :failure, to: 'RailsSimpleEventSourcing::Result'
+
       def initialize(command:)
         @command = command
       end
 
       def call
-        raise NoMethodError, "You must implement #{self.class}#call"
-      end
-
-      def success_result(data: nil)
-        RailsSimpleEventSourcing::Result.new(success?: true, data:)
-      end
-
-      def failure_result(errors:)
-        RailsSimpleEventSourcing::Result.new(success?: false, errors:)
+        raise NotImplementedError, "You must implement #{self.class}#call"
       end
     end
   end

data/lib/rails_simple_event_sourcing/commands/base.rb

@@ -4,7 +4,6 @@ module RailsSimpleEventSourcing
   module Commands
     class Base
       include ActiveModel::Model
-      include ActiveModel::Validations
 
       attr_accessor :aggregate_id
     end

data/lib/rails_simple_event_sourcing/result.rb

@@ -1,5 +1,42 @@
 # frozen_string_literal: true
 
 module RailsSimpleEventSourcing
-  Result = Struct.new(:success?, :data, :errors, keyword_init: true)
+  class Result
+    attr_reader :data, :errors
+
+    def self.success(data: nil)
+      new(success: true, data:)
+    end
+
+    def self.failure(errors:)
+      new(success: false, errors:)
+    end
+
+    def initialize(success:, data: nil, errors: nil)
+      raise ArgumentError, 'Successful result cannot have errors' if success && errors
+      raise ArgumentError, 'Failed result cannot have data' if !success && data
+
+      @success = success
+      @data    = data
+      @errors  = errors
+    end
+
+    def success?
+      @success
+    end
+
+    def on_success(&block)
+      raise ArgumentError, 'Block required' unless block
+
+      block.call(data) if success?
+      self
+    end
+
+    def on_failure(&block)
+      raise ArgumentError, 'Block required' unless block
+
+      block.call(errors) unless success?
+      self
+    end
+  end
 end

data/lib/rails_simple_event_sourcing/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsSimpleEventSourcing
-  VERSION = '1.0.8'
+  VERSION = '1.0.9'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails_simple_event_sourcing
 version: !ruby/object:Gem::Version
-  version: 1.0.8
+  version: 1.0.9
 platform: ruby
 authors:
 - Damian Baćkowski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-26 00:00:00.000000000 Z
+date: 2026-03-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pg