solid_objects 0.17.2 → 0.17.4

data/examples/guides/transactional_outbox/checkout.rb

@@ -0,0 +1,22 @@
+# rbs_inline: enabled
+
+class Checkout < SolidObjects::Actor
+  attribute :status, default: "open"
+  attribute :total_cents, default: 0
+  attribute :shipment_id, default: nil
+
+  def place(total_cents:)
+    return status unless status == "open"
+
+    self.status = "placed"
+    self.total_cents = total_cents
+    commit_action(:record_order, reference: actor_id, total_cents:)
+    emit(:request_shipment, order_reference: actor_id, on_success: :shipment_requested)
+    status
+  end
+
+  def shipment_requested(effect_id:, arguments:, result:)
+    self.status = "shipping"
+    self.shipment_id = result.fetch("shipment_id")
+  end
+end

data/examples/guides/transactional_outbox/order.rb

@@ -0,0 +1,17 @@
+# rbs_inline: enabled
+
+class Order < ApplicationRecord
+  def self.place_and_enqueue!(reference:, total_cents:)
+    order = create!(reference:, total_cents:)
+    ShipmentJob.perform_later(order_id: order.id)
+    order
+  end
+
+  def self.place_with_outbox!(reference:, total_cents:)
+    transaction do
+      order = create!(reference:, total_cents:)
+      OutboxMessage.create!(name: "request_shipment", arguments: { "order_id" => order.id })
+      order
+    end
+  end
+end

data/examples/guides/transactional_outbox/outbox_message.rb

@@ -0,0 +1,14 @@
+# rbs_inline: enabled
+
+class OutboxMessage < ApplicationRecord
+  JOBS = { "request_shipment" => ShipmentJob }.freeze
+
+  scope :pending, -> { where(delivered_at: nil).order(:id) }
+
+  def self.relay(limit: 100)
+    pending.limit(limit).each do |message|
+      JOBS.fetch(message.name).perform_later(**message.arguments.symbolize_keys)
+      message.update!(delivered_at: Time.current)
+    end
+  end
+end

data/examples/guides/transactional_outbox/shipment_job.rb

@@ -0,0 +1,8 @@
+# rbs_inline: enabled
+
+class ShipmentJob < ApplicationJob
+  def perform(order_id:)
+    order = Order.find(order_id)
+    ShippingProvider.create_shipment(idempotency_key: "order-#{order.id}", order_reference: order.reference)
+  end
+end

data/examples/guides/transactional_outbox/solid_objects.rb

@@ -0,0 +1,12 @@
+# rbs_inline: enabled
+
+SolidObjects.register_commit_action(:record_order) do |arguments, _context|
+  Order.create!(reference: arguments.fetch("reference"), total_cents: arguments.fetch("total_cents"))
+end
+
+SolidObjects.register_effect(:request_shipment) do |arguments, context|
+  ShippingProvider.create_shipment(
+    idempotency_key: context.id,
+    order_reference: arguments.fetch("order_reference")
+  )
+end

data/lib/solid_objects/activation.rb

@@ -139,6 +139,7 @@ module SolidObjects
           break
         end
 
+        renew_lease if processed_count.positive? && lease_renewal_due?
         message = claim_next_message
         break unless message
 

data/lib/solid_objects/lease.rb

@@ -123,6 +123,7 @@ module SolidObjects
         instance = Instance.lock.find_by(id: instance_id)
         next false unless instance
         next false unless owned_generation?(instance)
+        next false if ClaimedMessage.where(instance_id:).exists?
 
         instance.update!(
           activation_owner_id: nil,

data/lib/solid_objects/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solid_objects
 version: !ruby/object:Gem::Version
-  version: 0.17.2
+  version: 0.17.4
 platform: ruby
 authors:
 - Lucas Carlson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-08 00:00:00.000000000 Z
+date: 2026-10-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actioncable
@@ -362,6 +362,10 @@ files:
 - docs/development.md
 - docs/effect-recovery.md
 - docs/fit.md
+- docs/guides/expiring-reservations.md
+- docs/guides/ordered-jobs.md
+- docs/guides/race-conditions.md
+- docs/guides/transactional-outbox.md
 - docs/implementation-plan.md
 - docs/local-testing.md
 - docs/migrating-existing-state.md
@@ -391,6 +395,21 @@ files:
 - examples/at_least_once/demo.rb
 - examples/at_least_once/effect_worker.rb
 - examples/at_least_once/sink.rb
+- examples/guides/expiring_reservations/seat_inventory.rb
+- examples/guides/ordered_jobs/account.rb
+- examples/guides/ordered_jobs/apply_entry_job.rb
+- examples/guides/ordered_jobs/apply_entry_unordered_job.rb
+- examples/guides/ordered_jobs/create_ledger_entries.rb
+- examples/guides/ordered_jobs/ledger_account.rb
+- examples/guides/ordered_jobs/ledger_entry.rb
+- examples/guides/ordered_jobs/solid_objects.rb
+- examples/guides/race_conditions/event.rb
+- examples/guides/race_conditions/event_tickets.rb
+- examples/guides/transactional_outbox/checkout.rb
+- examples/guides/transactional_outbox/order.rb
+- examples/guides/transactional_outbox/outbox_message.rb
+- examples/guides/transactional_outbox/shipment_job.rb
+- examples/guides/transactional_outbox/solid_objects.rb
 - examples/quickstart/README.md
 - examples/quickstart/app/actors/ticket_sale.rb
 - examples/quickstart/smoke.rb