solid_objects 0.17.1 → 0.17.3

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/examples/quickstart/README.md

@@ -46,6 +46,9 @@ bin/rails db:migrate
 bin/rails solid_objects:doctor
 ```
 
+`bundle add solid_objects` installs the current release. Do not pin an older
+version from memory; the API changed between releases.
+
 The generator writes `config/initializers/solid_objects.rb` and copies the
 migrations. The migrations add the Solid Objects tables to the application's
 existing database.

data/lib/solid_objects/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solid_objects
 version: !ruby/object:Gem::Version
-  version: 0.17.1
+  version: 0.17.3
 platform: ruby
 authors:
 - Lucas Carlson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-08 00:00:00.000000000 Z
+date: 2026-10-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actioncable
@@ -280,7 +280,8 @@ description: 'Solid Objects is a SQL-backed virtual actor library for Ruby on Ra
   with durable state, ordered operations, and automatic activation. It brings the
   Cloudflare Durable Objects programming model to Rails: addressable objects with
   ordered mailboxes, fenced activation, per-object reminders, transactional effects,
-  and reactive ERB. It runs on MySQL, PostgreSQL, and SQLite without Redis.'
+  and reactive ERB. It runs on MySQL, PostgreSQL, and SQLite without Redis, and requires
+  Ruby 3.3 or newer and Rails 7.1 or newer.'
 email:
 executables:
 - solid_objects
@@ -361,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
@@ -390,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