eventsimple 2.2.1 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b24c718c0873c73f051bf040aba71527ca20f08237e6bf97c20f308ac654404f
-  data.tar.gz: 984f31379e00b61fee3afdcffa839386638840cbdca0f327d518ea6ee59ad4a5
+  metadata.gz: 394c4820e133907b2e63fe826b7891ab2cd0fbc1f436683b667ac9cfee73e57a
+  data.tar.gz: 70508717fa8b8a1b2528a38044648c3748b63ffd721c606ec66fdf959e54b53a
 SHA512:
-  metadata.gz: 02eaddfd2440ef2df26d7029e7b4e4dddda0be6797b0a4e8df0184935644e745fa807a25d12f10927a395b14a0c016b4325a590be62997d2c82a7752d72aee4a
-  data.tar.gz: 1818f9a233b7607248713c7e0d694cfd69342103ff9f394230908064ac756efd9be25a13683c1db46e2793f47f4b3b93343bf17fed8d63824e6331511edb131b
+  metadata.gz: 1150de14bcfc4580f7b2be46a406d602a29bcecb7b75aabd136215e8893fc8b4cc98fbfc29082cc1a7ac30cb7235e7ac81206e05532cdf260c74d8e68bf10176
+  data.tar.gz: 4d47af195c91593c5424c0f9a5316cd35e3c4aa9b135cbdb894fa86bcef72d899b1e6f1187afe063c627dbeb787d9bb0dfc310fc8de60ad0bbbf7d48cbbf4a60

data/CHANGELOG.md

@@ -6,6 +6,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Unreleased
 
+## 2.3.0 - 2026-02-24
+### Added
+- Per-event metadata class: pass `metadata_class:` to `drives_events_for` to use a custom metadata class for that event (Class or String).
+
+### Removed
+- Global `metadata_klass` configuration. Set metadata class per event via `drives_events_for(..., metadata_class: MyMetadata)` instead. Default remains `Eventsimple::Metadata` when omitted.
+
 ## 2.2.1 - 2026-02-03
 ### Removed
 - Removed `DateTime` type support. Use `Time` type instead. DateTime objects are no longer supported.

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    eventsimple (2.2.1)
+    eventsimple (2.3.0)
       concurrent-ruby (>= 1.2.3)
       dry-struct (>= 1.8.0)
       dry-types (>= 1.7.0)
@@ -458,7 +458,7 @@ CHECKSUMS
   dry-types (1.9.0) sha256=7b656fe0a78d2432500ae1f29fefd6762f5a032ca7000e4f36bc111453d45d4d
   erb (6.0.1) sha256=28ecdd99c5472aebd5674d6061e3c6b0a45c049578b071e5a52c2a7f13c197e5
   erubi (1.13.1) sha256=a082103b0885dbc5ecf1172fede897f9ebdb745a4b97a5e8dc63953db1ee4ad9
-  eventsimple (2.2.1)
+  eventsimple (2.3.0)
   factory_bot (6.5.6) sha256=12beb373214dccc086a7a63763d6718c49769d5606f0501e0a4442676917e077
   factory_bot_rails (6.5.1) sha256=d3cc4851eae4dea8a665ec4a4516895045e710554d2b5ac9e68b94d351bc6d68
   ffi (1.17.3-aarch64-linux-gnu) sha256=28ad573df26560f0aedd8a90c3371279a0b2bd0b4e834b16a2baa10bd7a97068

data/lib/eventsimple/configuration.rb

@@ -3,13 +3,12 @@
 module Eventsimple
   class Configuration
     attr_reader :max_concurrency_retries
-    attr_writer :metadata_klass, :parent_record_klass
+    attr_writer :parent_record_klass
     attr_accessor :retry_reactor_on_record_not_found, :ui_visible_model_names
 
     def initialize
       @dispatchers = []
       @max_concurrency_retries = 2
-      @metadata_klass = 'Eventsimple::Metadata'
       @parent_record_klass = 'ApplicationRecord'
       @retry_reactor_on_record_not_found = false
 
@@ -41,10 +40,6 @@ module Eventsimple
       @dispatchers_klass_consts ||= @dispatchers.map(&:constantize)
     end
 
-    def metadata_klass
-      @metadata_klass_const ||= @metadata_klass.constantize
-    end
-
     def parent_record_klass
       @parent_record_const ||= @parent_record_klass.constantize
     end

data/lib/eventsimple/event.rb

@@ -5,7 +5,7 @@ module Eventsimple
     require 'globalid'
     include GlobalID::Identification
 
-    def drives_events_for(aggregate_klass, aggregate_id:, events_namespace: nil)
+    def drives_events_for(aggregate_klass, aggregate_id:, events_namespace: nil, metadata_class: nil)
       begin
         if defined?(aggregate_klass._aggregate_id) && aggregate_klass.table_exists? && table_exists?
           raise ArgumentError, "aggregate_id mismatch event:#{aggregate_id} entity:#{aggregate_klass._aggregate_id}" if aggregate_id != aggregate_klass._aggregate_id
@@ -34,10 +34,13 @@ module Eventsimple
       class_attribute :_on_invalid_transition
       self._on_invalid_transition = ->(error) { raise error }
 
+      class_attribute :_metadata_klass
+      self._metadata_klass = metadata_class.is_a?(Class) ? metadata_class : metadata_class&.to_s&.constantize
+
       self.inheritance_column = 'type'
       self.store_full_sti_class = false
 
-      attribute :metadata, MetadataType.new
+      attribute :metadata, MetadataType.new(self)
       attr_writer :skip_dispatcher
       attr_writer :skip_apply_check
 
@@ -164,6 +167,10 @@ module Eventsimple
         self._on_invalid_transition = block || ->(error) {}
       end
 
+      def resolve_metadata_klass
+        _metadata_klass || Eventsimple::Metadata
+      end
+
       # We don't store the full namespaced class name in the events table.
       # Events for an entity are expected to be namespaced under _events_namespace.
       def find_sti_class(type_name)

data/lib/eventsimple/metadata_type.rb

@@ -2,27 +2,36 @@
 
 module Eventsimple
   class MetadataType < ActiveModel::Type::Value
+    def initialize(event_class)
+      super()
+      @event_class = event_class
+    end
+
     def type
       :metadata_type
     end
 
+    def metadata_klass
+      @metadata_klass ||= @event_class.resolve_metadata_klass
+    end
+
     def cast_value(value)
       case value
       when String
         decoded = ActiveSupport::JSON.decode(value)
         return decoded if decoded.empty?
 
-        Eventsimple.configuration.metadata_klass.new(decoded)
+        metadata_klass.new(decoded)
       when Hash
-        Eventsimple.configuration.metadata_klass.new(value)
-      when Eventsimple.configuration.metadata_klass
+        metadata_klass.new(value)
+      when metadata_klass
         value
       end
     end
 
     def serialize(value)
       case value
-      when Hash, Eventsimple.configuration.metadata_klass
+      when Hash, metadata_klass
         ActiveSupport::JSON.encode(value)
       else
         super
@@ -32,7 +41,7 @@ module Eventsimple
     def deserialize(value)
       decoded = ActiveSupport::JSON.decode(value)
 
-      Eventsimple.configuration.metadata_klass.new(decoded)
+      metadata_klass.new(decoded)
     end
   end
 end

data/lib/eventsimple/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: eventsimple
 version: !ruby/object:Gem::Version
-  version: 2.2.1
+  version: 2.3.0
 platform: ruby
 authors:
 - Zulfiqar Ali