orfeas_lyra 0.9.1 → 0.9.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1ad6e90ac8c41a250e5657e98d515ae6dc1c67ac143ac0e09b5aa03da8d519e5
-  data.tar.gz: 3f901f07baca22e6e7a20d670d2511e6ed29ee0897d9ace09046a744178c4398
+  metadata.gz: 4a75016e10096d61497bb69e58b2570d23ca9a99a8206377fe94216d1db26eb9
+  data.tar.gz: a139ef32e0dd3e83ba2c5ce1f182e6cb83360f2208faea20a1330536ee63edae
 SHA512:
-  metadata.gz: 83812774c35b098d728b340806597d9e7949ae813f3005ab76f6d032628acef6bc38aad567f4c15a50f90f315e0c34a681dedf11b327ed2a60e53f25e7f1fb71
-  data.tar.gz: f73b3d73337a165cb8160854468ba0d8fc9bfb86678eafa9f463a517cffbdd85a2effce8460bcc2168d85cbea9fabb748ea16a6b5c9f17d7380ba832fe4c5f5c
+  metadata.gz: 9d8e2c114fcae82c8dd8735758da868eb4e2aef90f4c7ad53f1385b6f39d8d182f57e9026d8e90d4a283501ae6a7fcdb97889d989183deee427252794fb1d8b4
+  data.tar.gz: 6817174882333de4336a7907cae0a47c1690712f85ec1f1cb96cd676e4b6ada397cf17c64a1249a5a96623cc5a33ee60c728f5c92d1ffc80bcede9ac4aa76e42

data/CHANGELOG.md

@@ -7,13 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.2] - 2026-11-03
+
+One fix in Lyra; PAM DSL and PetriFlow are unchanged (0.9.1).
+
+### Fixed
+- **ES-Async read-your-writes no longer races a projection job.** With read-your-writes
+  (`each_write: true`), the writer projected its own event without the per-stream lock that
+  `AsyncProjectionJob` holds. A job that had read the record's stream before that event
+  committed could write the row afterwards, putting it back to the older value until the newer
+  event's job ran: a reader in between saw the record step back (an application's suite, run
+  with real background projection, read a refund as "approved" just after it was "processed").
+  `Lyra::Consistency::ReadYourWrites` now takes the job's lock before projecting, held to the
+  end of the writer's transaction. Final states converged before as well. Plain ES-Async (no
+  read-your-writes) was not affected. `test/concurrent_same_record_test.rb` reproduces the
+  interleaving.
+
 ## [0.9.1] - 2026-11-02
 
 Lyra's changes since 0.9.0; PAM DSL and PetriFlow change only in their gem descriptions.
 
 ### Released
 - The gems on RubyGems (`orfeas_lyra`, `orfeas_petri_flow`, `orfeas_pam_dsl`), built from tag
-  `v0.9.1`
+  `v0.9.1` and pushed on 2026-11-02
 
 ### Added
 - **Writes are grouped into causal chains by default** (`config.correlate_writes`, on). Before,

data/README.md

@@ -52,7 +52,8 @@ seven configurations:
 - PostgreSQL. Lyra depends on the `pg` gem; the advisory locks behind Genesis
   and ES-Lazy, and id reservation in Hijack mode, need PostgreSQL.
 
-The gem names differ from the files to require:
+The gems are on RubyGems, at 0.9.1 (2 November 2026). Their names differ from the
+files to require:
 
 ```ruby
 # Gemfile

data/lib/lyra/consistency/read_your_writes.rb

@@ -89,12 +89,34 @@ module Lyra
           (Thread.current[:lyra_pending_writes] || []).each { |write| project(write) }
         end
 
+        # Projects under the lock AsyncProjectionJob holds per stream, taken
+        # in the writer's transaction (or one of its own) and held to its end.
+        # A job that had read the stream before this write committed would
+        # otherwise write the row after this projection, putting it back to
+        # the older value until the newer event's job ran. With the lock, this
+        # projection waits for a job in flight; a job that starts after it
+        # reads a stream that already holds this write's event.
         def project(write)
-          Lyra::Projections::ModelProjection.project(write[:model_class], write[:operation], write[:result])
+          model_class = write[:model_class]
+          model_class.transaction do
+            lock_stream(model_class, write[:result])
+            Lyra::Projections::ModelProjection.project(model_class, write[:operation], write[:result])
+          end
         rescue => e
           Rails.logger.error("Lyra: Failed to ensure projection - #{e.message}")
           raise if Lyra.config.strict_projections
         end
+
+        # The same key AsyncProjectionJob#lock_stream! locks: the record's
+        # stream name, from the model id its event carries.
+        def lock_stream(model_class, result)
+          data = result.events&.first&.data
+          model_id = data && (data[:model_id] || data["model_id"])
+          return unless model_id
+
+          stream = Lyra.stream_name(model_class, model_id)
+          model_class.with_connection { |c| Lyra::AdvisoryLock.xact_lock(c, stream, purpose: "read-your-writes projection") }
+        end
       end
     end
 

data/lib/lyra/version.rb

@@ -1,3 +1,3 @@
 module Lyra
-  VERSION = "0.9.1"
+  VERSION = "0.9.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: orfeas_lyra
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.9.2
 platform: ruby
 authors:
 - Michail Pantelelis