rails_simple_event_sourcing 1.0.1 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 686785bc4c8f52ae548b2880cb664b57d5a048925cda0f4cfe0d2962acbfdb3e
-  data.tar.gz: 9555f13015e4aaacdfe8ce8b4866ea8d5f6e1a19d0d4f0766b1d4b9c5b36a64e
+  metadata.gz: baad400eca4ab6e7629c1bc7a9d30f66841d2da8ee1d3ab1dd3225333bf9ea10
+  data.tar.gz: dd2e881c3f8693aadae17ed44343acbb2633465eaf36d010934173793b91daf3
 SHA512:
-  metadata.gz: ba9de2c72e6ff9c242da76379ae476aa1139bba37b58eb60dced8bd6c37de83dc3335e9d2f031a6ccf3930e7211f1bafc96c65647550a020e7dcd71e262207d2
-  data.tar.gz: 691d056df008df794ae8b4833295185eb0ee6f568b2f28b19d2ddbea79bec4069b64143a1c4723c685f49030be97c1e0f964d53ae451551efd1fc6813f4f7c39
+  metadata.gz: c1ed4111dd95c2e6f0bba524606749e98d22c78d7803ea0b1dc2f0f03a27ef39e070d868d25b5ac2491389db08c154221432c2374d647d343299cd2469eb0656
+  data.tar.gz: 44764791b5a57ad810562f1dbf32f5b17f59ee19c047092c19751db5470498cb56797e6c82aece230ddae68ac820dd6505a5ab8e86433d582bb002fef984c7a4

data/README.md

@@ -213,16 +213,47 @@ Events represent **facts** - things that have already happened in your system. T
 - Store immutable data about state changes
 - Use past tense naming (e.g., `CustomerCreated`, not `CreateCustomer`)
 - Define which aggregate (model) they apply to
-- Specify how to apply themselves to the aggregate
 - Are stored permanently in the event log
 
 **Key Concepts:**
 - `aggregate_class` - The model this event applies to (optional - some events may not modify models)
 - `event_attributes` - Fields stored in the event payload
-- `apply(aggregate)` - Method that applies the event to an aggregate instance
+- `apply(aggregate)` - **Optional** method that applies the event to an aggregate instance
 - `aggregate_id` - Links the event to a specific aggregate instance
 
-**Example - Create Event:**
+**Example - Basic Event (Automatic Application):**
+
+```ruby
+class Customer
+  module Events
+    class CustomerCreated < RailsSimpleEventSourcing::Event
+      aggregate_class Customer
+      event_attributes :first_name, :last_name, :email, :created_at, :updated_at
+    end
+  end
+end
+```
+
+**Automatic Attribute Application:**
+
+By default, all attributes declared in `event_attributes` will be **automatically applied** to the aggregate. You don't need to implement the `apply` method unless you have custom logic requirements.
+
+The default implementation sets each event attribute on the aggregate:
+```ruby
+# This happens automatically
+aggregate.first_name = first_name
+aggregate.last_name = last_name
+aggregate.email = email
+# ... and so on for all event_attributes
+```
+
+**Example - Custom Apply Method (When Needed):**
+
+You may still need to implement a custom `apply` method in certain cases:
+- Setting computed or derived values
+- Complex business logic during application
+- Handling nested objects or special data transformations
+- Setting the aggregate ID explicitly (though this is usually handled automatically)
 
 ```ruby
 class Customer
@@ -232,12 +263,13 @@ class Customer
       event_attributes :first_name, :last_name, :email, :created_at, :updated_at
 
       def apply(aggregate)
+        # Custom logic example
         aggregate.id = aggregate_id
-        aggregate.first_name = first_name
-        aggregate.last_name = last_name
-        aggregate.email = email
-        aggregate.created_at = created_at
-        aggregate.updated_at = updated_at
+        aggregate.full_name = "#{first_name} #{last_name}"  # Computed value
+        aggregate.email_normalized = email.downcase.strip   # Transformation
+
+        # You can still call super to apply remaining attributes automatically
+        super
       end
     end
   end
@@ -246,8 +278,8 @@ end
 
 **Understanding the Event Structure:**
 - `aggregate_class Customer` - Specifies which model this event modifies
-- `event_attributes` - Defines what data gets stored in the event's JSON payload
-- `apply(aggregate)` - Receives an aggregate instance and applies the event's changes to it
+- `event_attributes` - Defines what data gets stored in the event's JSON payload and what will be automatically applied
+- `apply(aggregate)` - Optional method; only implement if you need custom logic beyond automatic attribute assignment
 - `aggregate_id` - Auto-generated for creates, must be provided for updates/deletes
 
 **Note on aggregate_class:**
@@ -487,9 +519,7 @@ class Customer::Events::CustomerDeleted < RailsSimpleEventSourcing::Event
   aggregate_class Customer
   event_attributes :deleted_at
 
-  def apply(aggregate)
-    aggregate.deleted_at = deleted_at
-  end
+  # No need to implement apply - deleted_at will be automatically set on the aggregate
 end
 ```
 

data/app/models/rails_simple_event_sourcing/event.rb

@@ -15,9 +15,11 @@ module RailsSimpleEventSourcing
     before_validation :apply_event_to_aggregate, on: :create, if: :aggregate_defined?
     before_save :persist_aggregate, if: :aggregate_defined?
 
-    # Must be implemented by subclasses
-    def apply(_aggregate)
-      raise NotImplementedError, "#{self.class}#apply must be implemented"
+    def apply(aggregate)
+      payload.each do |key, value|
+        aggregate.send("#{key}=", value) if aggregate.respond_to?("#{key}=") && value.present?
+      end
+      aggregate
     end
 
     private

data/lib/rails_simple_event_sourcing/version.rb

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

metadata

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