solid_objects 0.16.1 → 0.17.1

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

@@ -0,0 +1,30 @@
+# Generated from lib/solid_objects/telemetry.rb with RBS::Inline
+
+module SolidObjects
+  module Telemetry
+    FIELDS: Array[String]
+
+    ALIASES: Hash[String, String]
+
+    # @rbs (Effect | Broadcast) -> void
+    def self.outbox: (Effect | Broadcast) -> void
+
+    # @rbs (Symbol, Hash[Symbol, Object]) -> void
+    def self.emit: (Symbol, Hash[Symbol, Object]) -> void
+
+    # @rbs (event_observer, portable_event) -> void
+    def self.deliver: (event_observer, portable_event) -> void
+
+    # @rbs (Symbol, Hash[Symbol, Object]) -> portable_event
+    def self.event: (Symbol, Hash[Symbol, Object]) -> portable_event
+
+    # @rbs (Hash[Symbol, Object]) -> Hash[String, telemetry_value]
+    def self.safe_attributes: (Hash[Symbol, Object]) -> Hash[String, telemetry_value]
+
+    # @rbs (Effect | Broadcast) -> Hash[Symbol, String | Integer]
+    private def self.outbox_identity: (Effect | Broadcast) -> Hash[Symbol, String | Integer]
+
+    # @rbs (String, Exception) -> void
+    private def self.log_delivery_failure: (String, Exception) -> void
+  end
+end

data/sig/generated/lib/solid_objects.rbs

@@ -27,6 +27,9 @@ module SolidObjects
   # @rbs (String | Symbol) { (Hash[String, untyped], CommitActionContext) -> untyped } -> Proc
   def self.register_commit_action: (String | Symbol) { (Hash[String, untyped], CommitActionContext) -> untyped } -> Proc
 
+  # @rbs () -> ObserverRegistry
+  def self.observer_registry: () -> ObserverRegistry
+
   # @rbs () -> Client
   def self.client: () -> Client
 

data/sig/generated/models/solid_objects/message.rbs

@@ -17,6 +17,9 @@ module SolidObjects
     # @rbs () -> bool
     def dead?: () -> bool
 
+    # @rbs () -> json_value
+    def result!: () -> json_value
+
     private
 
     # @rbs () -> void

data/sig/public/json_value.rbs

@@ -0,0 +1,3 @@
+module SolidObjects
+  type json_value = String | Integer | Float | bool | nil | Array[json_value] | Hash[String, json_value]
+end

data/sig/public/telemetry.rbs

@@ -0,0 +1,49 @@
+module SolidObjects
+  type telemetry_value = String | Integer | Float | bool | nil
+
+  type metric_sample = {
+    "name" => String,
+    "kind" => "counter" | "gauge" | "histogram",
+    "unit" => "1" | "ms",
+    "value" => Integer | Float,
+    "labels" => Hash[String, String]
+  }
+
+  type portable_event = {
+    "schemaVersion" => Integer,
+    "name" => String,
+    "occurredAt" => String,
+    "adapter" => String,
+    "actorType" => String?,
+    "actorId" => String?,
+    "incarnation" => String?,
+    "revision" => String?,
+    "messageId" => String?,
+    "attempt" => Integer,
+    "attributes" => Hash[String, telemetry_value],
+    "metrics" => Array[metric_sample]
+  }
+
+  type event_observer = ^(portable_event) -> void
+
+  type diagnostic_summary = {
+    "sampled" => Integer,
+    "truncated" => bool,
+    "oldestAgeMilliseconds" => Integer?
+  }
+
+  type actor_diagnostics = {
+    "actorType" => String,
+    "actorId" => String,
+    "incarnation" => String?,
+    "revision" => String?,
+    "adapter" => String,
+    "occurredAt" => String,
+    "limit" => Integer,
+    "mailbox" => diagnostic_summary,
+    "outbox" => diagnostic_summary,
+    "reminders" => diagnostic_summary,
+    "retries" => diagnostic_summary,
+    "recoveryFailures" => diagnostic_summary
+  }
+end

data/sig/support/framework.rbs

@@ -9,6 +9,11 @@ end
 module ActiveSupport
   class MessageVerifier
   end
+
+  module Notifications
+    class Event
+    end
+  end
 end
 
 module ActionCable

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solid_objects
 version: !ruby/object:Gem::Version
-  version: 0.16.1
+  version: 0.17.1
 platform: ruby
 authors:
 - Lucas Carlson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-03 00:00:00.000000000 Z
+date: 2026-10-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actioncable
@@ -276,10 +276,11 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '2.7'
-description: 'The Cloudflare Durable Objects programming model for Rails: addressable
-  objects with durable state, ordered mailboxes, fenced activation, per-object alarms,
-  transactional effects, and reactive ERB. It runs on MySQL, PostgreSQL, and SQLite
-  without requiring Redis.'
+description: 'Solid Objects is a SQL-backed virtual actor library for Ruby on Rails,
+  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.'
 email:
 executables:
 - solid_objects
@@ -350,6 +351,7 @@ files:
 - docs/adr/0011-wake-up-strategy.md
 - docs/adr/0012-not-active-jobs.md
 - docs/adr/0013-database-adapters.md
+- docs/agents.md
 - docs/architecture.md
 - docs/authorization.md
 - docs/benchmarks.md
@@ -362,6 +364,7 @@ files:
 - docs/implementation-plan.md
 - docs/local-testing.md
 - docs/migrating-existing-state.md
+- docs/observability.md
 - docs/operations.md
 - docs/realtime.md
 - docs/reminders.md
@@ -370,6 +373,7 @@ files:
 - docs/security.md
 - docs/state-migrations.md
 - docs/transmission.md
+- docs/virtual-actors.md
 - examples/application/README.md
 - examples/application/app/actors/chat_room_actor.rb
 - examples/application/app/actors/shopping_cart_actor.rb
@@ -386,6 +390,9 @@ files:
 - examples/at_least_once/demo.rb
 - examples/at_least_once/effect_worker.rb
 - examples/at_least_once/sink.rb
+- examples/quickstart/README.md
+- examples/quickstart/app/actors/ticket_sale.rb
+- examples/quickstart/smoke.rb
 - exe/solid_objects
 - lib/generators/solid_objects/install_generator.rb
 - lib/generators/solid_objects/templates/solid_objects.rb
@@ -425,6 +432,7 @@ files:
 - lib/solid_objects/dead_letter_manager.rb
 - lib/solid_objects/dead_letter_scope.rb
 - lib/solid_objects/dead_row.rb
+- lib/solid_objects/diagnostics.rb
 - lib/solid_objects/doctor.rb
 - lib/solid_objects/dom_identity.rb
 - lib/solid_objects/effect_executor.rb
@@ -442,6 +450,7 @@ files:
 - lib/solid_objects/mailbox.rb
 - lib/solid_objects/message_pruner.rb
 - lib/solid_objects/message_reference.rb
+- lib/solid_objects/observer_registry.rb
 - lib/solid_objects/operation_dispatcher.rb
 - lib/solid_objects/outcome.rb
 - lib/solid_objects/payload_broadcast.rb
@@ -464,6 +473,7 @@ files:
 - lib/solid_objects/sync_deadline.rb
 - lib/solid_objects/sync_diagnostics.rb
 - lib/solid_objects/synchronous_invocation.rb
+- lib/solid_objects/telemetry.rb
 - lib/solid_objects/test_helper.rb
 - lib/solid_objects/transmission.rb
 - lib/solid_objects/turbo_stream_renderer.rb
@@ -527,6 +537,7 @@ files:
 - sig/generated/lib/solid_objects/dead_letter_manager.rbs
 - sig/generated/lib/solid_objects/dead_letter_scope.rbs
 - sig/generated/lib/solid_objects/dead_row.rbs
+- sig/generated/lib/solid_objects/diagnostics.rbs
 - sig/generated/lib/solid_objects/doctor.rbs
 - sig/generated/lib/solid_objects/dom_identity.rbs
 - sig/generated/lib/solid_objects/effect_executor.rbs
@@ -544,6 +555,7 @@ files:
 - sig/generated/lib/solid_objects/mailbox.rbs
 - sig/generated/lib/solid_objects/message_pruner.rbs
 - sig/generated/lib/solid_objects/message_reference.rbs
+- sig/generated/lib/solid_objects/observer_registry.rbs
 - sig/generated/lib/solid_objects/operation_dispatcher.rbs
 - sig/generated/lib/solid_objects/outcome.rbs
 - sig/generated/lib/solid_objects/payload_broadcast.rbs
@@ -566,6 +578,7 @@ files:
 - sig/generated/lib/solid_objects/sync_deadline.rbs
 - sig/generated/lib/solid_objects/sync_diagnostics.rbs
 - sig/generated/lib/solid_objects/synchronous_invocation.rbs
+- sig/generated/lib/solid_objects/telemetry.rbs
 - sig/generated/lib/solid_objects/test_helper.rbs
 - sig/generated/lib/solid_objects/transmission.rbs
 - sig/generated/lib/solid_objects/turbo_stream_renderer.rbs
@@ -599,7 +612,9 @@ files:
 - sig/generated/models/solid_objects/redrive.rbs
 - sig/generated/models/solid_objects/reminder.rbs
 - sig/public/effect_payload.rbs
+- sig/public/json_value.rbs
 - sig/public/reminder_payload.rbs
+- sig/public/telemetry.rbs
 - sig/support/framework.rbs
 - web/assets/javascripts/application.js
 - web/assets/javascripts/charts.js
@@ -621,7 +636,7 @@ files:
 - web/views/message.erb
 - web/views/processes.erb
 - web/views/reminders.erb
-homepage: https://solidobjects.dev
+homepage: https://solidobjects.dev/ruby
 licenses:
 - MIT
 metadata:
@@ -629,7 +644,7 @@ metadata:
   bug_tracker_uri: https://github.com/cardmagic/solid-objects-ruby/issues
   changelog_uri: https://github.com/cardmagic/solid-objects-ruby/blob/main/CHANGELOG.md
   documentation_uri: https://github.com/cardmagic/solid-objects-ruby#readme
-  homepage_uri: https://solidobjects.dev
+  homepage_uri: https://solidobjects.dev/ruby
   rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/cardmagic/solid-objects-ruby
 post_install_message:
@@ -650,5 +665,5 @@ requirements: []
 rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
-summary: Cloudflare Durable Objects, ported to Rails
+summary: SQL-backed virtual actors for Ruby on Rails
 test_files: []