solid_objects 0.15.1 → 0.15.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b9179610a28d7c335fbffb11a9a86009c15ae4b1e7e2e1a4f638a69c64085b85
-  data.tar.gz: bc67c66ad2f7841eb32724d5d8cbcb744250fb4f0579c7fdb6546e1a9b259fd5
+  metadata.gz: 55b365960ffe5f49934eb8914e35d546af1de656e158477977caf8c75db19fcd
+  data.tar.gz: fcea896079cc1f85eb60e6cbc13d080c597a8074a077cf32a1e34142b5055886
 SHA512:
-  metadata.gz: 9786fdf1d29ff91f145d47f5a5523d6371ebe3bd1623af0fde9652c4327e52c12e90f540e5d9623e5e79ca616656c580759830e31577bd0d0a88335a15a1ddd7
-  data.tar.gz: 3b1513d225edc9f56e7063e9517d9abe7f41b3e2b59e37c93fb269d0b63a9e6963e7442d3e5033361a9ba7aeb0f39859d0bd4e911be1f51e7d77a0940e999a85
+  metadata.gz: 6c21e96eb84ebbaf519c8860b79d952f3daa5d647f6ca0de6d35527b5b24bab53fd086c35fb57446a1173798f4c2849034d368415ff4afaacccedb509e768f23
+  data.tar.gz: f11760f2484478b62ad93cf18327aaa9f5a9d53b7b451c8f1233a479854a3f50b75b369f8559d06295794ea19cad30696088889b3258a541c4003f5775cec2fc

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.15.2 - 2026-09-21
+
+- Find the actor instance before the insert when an enqueue starts, and lock
+  that row by its primary key. A steady-state enqueue now writes no instance
+  row and issues 10 statements instead of 12.
+- Stop the deadlock between concurrent enqueues that create the same actor
+  inside a transaction that already wrote. MySQL keeps the shared lock of a
+  failed insert across a savepoint rollback, so the mailbox reads the winning
+  row in shared mode and never asks to upgrade that lock.
+
 ## 0.15.1 - 2026-09-16
 
 - Use the existing cleanup index when finding expired actor instances. Preserve

data/docs/roadmap.md

@@ -6,7 +6,12 @@
 - Explicit actor registry, references, JSON state, and state migrations
 - Fluent direct synchronous RPC, configured `sync`, and durable `async`
 - Durable message history plus ready/claimed membership tables
-- Concurrent sequence allocation and actor creation
+- Concurrent sequence allocation and actor creation. An enqueue finds the
+  instance row with an unlocked read, then locks that row by its primary key.
+  A steady-state enqueue writes no instance row, and issues 10 statements
+  instead of 12. Concurrent creation causes no deadlock on SQLite, PostgreSQL,
+  or MySQL. MySQL needs a shared read after a duplicate key, because it uses
+  repeatable read. The tests count statements, and do not measure latency.
 - Activation leases, renewal, unique activation tokens, generations, and
   fenced commits
 - Bounded activation passes, idle cache, hot-actor yield, and process records

data/lib/solid_objects/database_adapter.rb

@@ -99,6 +99,11 @@ module SolidObjects
       nil
     end
 
+    # @rbs () -> String?
+    def shared_lock
+      nil
+    end
+
     # @rbs () -> String
     def current_time_expression
       "CURRENT_TIMESTAMP"
@@ -163,6 +168,11 @@ module SolidObjects
       claim_lock ? relation.lock(claim_lock) : relation
     end
 
+    # @rbs (ActiveRecord::Relation[untyped]) -> ActiveRecord::Relation[untyped]
+    def share_locked(relation)
+      shared_lock ? relation.lock(shared_lock) : relation
+    end
+
     private
 
     attr_reader :connection_pool, :fixed_connection

data/lib/solid_objects/database_adapters/mysql.rb

@@ -15,6 +15,11 @@ module SolidObjects
         "FOR UPDATE SKIP LOCKED"
       end
 
+      # @rbs () -> String
+      def shared_lock
+        "FOR SHARE"
+      end
+
       # A non-transactional engine would silently break fenced commits, so the
       # storage engine is verified rather than assumed.
       # @rbs () -> Array[String]

data/lib/solid_objects/mailbox.rb

@@ -52,7 +52,6 @@ module SolidObjects
         max_bytes: SolidObjects.configuration.max_payload_bytes
       )
       instance = find_or_create_instance(reference, actor_class)
-      instance.lock!
 
       existing = find_idempotent_message(instance, idempotency_key)
       if existing
@@ -108,13 +107,23 @@ module SolidObjects
 
     # @rbs (Reference, Class) -> Instance
     def find_or_create_instance(reference, actor_class)
-      Instance.create_or_find_by!(
-        actor_type: reference.actor_type,
-        actor_id: reference.actor_id
-      ) do |instance|
-        instance.state = {}
-        instance.state_version = actor_class.state_version
+      identity = { actor_type: reference.actor_type, actor_id: reference.actor_id }
+      identifier = Instance.where(identity).pick(:id)
+      return lock_instance!(identifier) if identifier
+
+      Instance.transaction(requires_new: true) do
+        Instance.create!(**identity, state: {}, state_version: actor_class.state_version)
       end
+    rescue ActiveRecord::RecordNotUnique
+      lock_instance!(database_adapter.share_locked(Instance.where(identity)).pick(:id))
+    end
+
+    # @rbs (Integer?) -> Instance
+    def lock_instance!(identifier)
+      instance = identifier && Instance.lock.find_by(id: identifier)
+      return instance if instance
+
+      raise ActiveRecord::RecordNotFound, "actor instance disappeared while enqueueing"
     end
 
     # @rbs (Instance, String?) -> Message?

data/lib/solid_objects/version.rb

@@ -1,5 +1,5 @@
 # rbs_inline: enabled
 
 module SolidObjects
-  VERSION = "0.15.1"
+  VERSION = "0.15.2"
 end

data/sig/generated/lib/solid_objects/database_adapter.rbs

@@ -49,6 +49,9 @@ module SolidObjects
     # @rbs () -> String?
     def claim_lock: () -> String?
 
+    # @rbs () -> String?
+    def shared_lock: () -> String?
+
     # @rbs () -> String
     def current_time_expression: () -> String
 
@@ -70,6 +73,9 @@ module SolidObjects
     # @rbs (ActiveRecord::Relation[untyped]) -> ActiveRecord::Relation[untyped]
     def lock_candidates: (ActiveRecord::Relation[untyped]) -> ActiveRecord::Relation[untyped]
 
+    # @rbs (ActiveRecord::Relation[untyped]) -> ActiveRecord::Relation[untyped]
+    def share_locked: (ActiveRecord::Relation[untyped]) -> ActiveRecord::Relation[untyped]
+
     private
 
     attr_reader connection_pool: untyped

data/sig/generated/lib/solid_objects/database_adapters/mysql.rbs

@@ -11,6 +11,9 @@ module SolidObjects
       # @rbs () -> String
       def claim_lock: () -> String
 
+      # @rbs () -> String
+      def shared_lock: () -> String
+
       # A non-transactional engine would silently break fenced commits, so the
       # storage engine is verified rather than assumed.
       # @rbs () -> Array[String]

data/sig/generated/lib/solid_objects/mailbox.rbs

@@ -28,6 +28,9 @@ module SolidObjects
     # @rbs (Reference, Class) -> Instance
     def find_or_create_instance: (Reference, Class) -> Instance
 
+    # @rbs (Integer?) -> Instance
+    def lock_instance!: (Integer?) -> Instance
+
     # @rbs (Instance, String?) -> Message?
     def find_idempotent_message: (Instance, String?) -> Message?
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solid_objects
 version: !ruby/object:Gem::Version
-  version: 0.15.1
+  version: 0.15.2
 platform: ruby
 authors:
 - Lucas Carlson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-16 00:00:00.000000000 Z
+date: 2026-09-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actioncable