solid_objects 0.10.3 → 0.12.0

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

@@ -71,7 +71,7 @@ module SolidObjects
 
     @actor_id: String
 
-    @message_name: String
+    @operation: String
 
     attr_reader timeout: untyped
 
@@ -79,10 +79,10 @@ module SolidObjects
 
     attr_reader actor_id: untyped
 
-    attr_reader message_name: untyped
+    attr_reader operation: untyped
 
-    # @rbs (timeout: Numeric, actor_type: String, actor_id: String, message_name: String) -> void
-    def initialize: (timeout: Numeric, actor_type: String, actor_id: String, message_name: String) -> void
+    # @rbs (timeout: Numeric, actor_type: String, actor_id: String, operation: String) -> void
+    def initialize: (timeout: Numeric, actor_type: String, actor_id: String, operation: String) -> void
   end
 
   class SyncTimeout < Error
@@ -92,7 +92,7 @@ module SolidObjects
 
     @actor_id: String
 
-    @message_name: String
+    @operation: String
 
     @message_id: Integer
 
@@ -114,7 +114,7 @@ module SolidObjects
 
     attr_reader actor_id: untyped
 
-    attr_reader message_name: untyped
+    attr_reader operation: untyped
 
     attr_reader message_id: untyped
 
@@ -130,8 +130,8 @@ module SolidObjects
 
     attr_reader blocker: untyped
 
-    # @rbs (timeout: Numeric, actor_type: String, actor_id: String, message_name: String, message_id: Integer, request_id: String, sequence: Integer, status: String, waiting_on: String, activation: Hash[String, untyped], blocker: Hash[String, untyped]?) -> void
-    def initialize: (timeout: Numeric, actor_type: String, actor_id: String, message_name: String, message_id: Integer, request_id: String, sequence: Integer, status: String, waiting_on: String, activation: Hash[String, untyped], blocker: Hash[String, untyped]?) -> void
+    # @rbs (timeout: Numeric, actor_type: String, actor_id: String, operation: String, message_id: Integer, request_id: String, sequence: Integer, status: String, waiting_on: String, activation: Hash[String, untyped], blocker: Hash[String, untyped]?) -> void
+    def initialize: (timeout: Numeric, actor_type: String, actor_id: String, operation: String, message_id: Integer, request_id: String, sequence: Integer, status: String, waiting_on: String, activation: Hash[String, untyped], blocker: Hash[String, untyped]?) -> void
 
     # @rbs () -> MessageReference
     def message_reference: () -> MessageReference
@@ -142,16 +142,16 @@ module SolidObjects
 
     @actor_id: String
 
-    @message_name: String
+    @operation: String
 
     attr_reader actor_type: untyped
 
     attr_reader actor_id: untyped
 
-    attr_reader message_name: untyped
+    attr_reader operation: untyped
 
-    # @rbs (actor_type: String, actor_id: String, message_name: String) -> void
-    def initialize: (actor_type: String, actor_id: String, message_name: String) -> void
+    # @rbs (actor_type: String, actor_id: String, operation: String) -> void
+    def initialize: (actor_type: String, actor_id: String, operation: String) -> void
   end
 
   class ApplicationWriteForbidden < NonRetryableError
@@ -159,21 +159,21 @@ module SolidObjects
 
     @actor_id: String
 
-    @message_name: String
+    @operation: String
 
     attr_reader actor_type: untyped
 
     attr_reader actor_id: untyped
 
-    attr_reader message_name: untyped
+    attr_reader operation: untyped
 
-    # @rbs (actor_type: String, actor_id: String, message_name: String) -> void
-    def initialize: (actor_type: String, actor_id: String, message_name: String) -> void
+    # @rbs (actor_type: String, actor_id: String, operation: String) -> void
+    def initialize: (actor_type: String, actor_id: String, operation: String) -> void
   end
 
   class CommitActionUnavailable < NonRetryableError
-    # @rbs (actor_type: String, actor_id: String, message_name: String) -> void
-    def initialize: (actor_type: String, actor_id: String, message_name: String) -> void
+    # @rbs (actor_type: String, actor_id: String, operation: String) -> void
+    def initialize: (actor_type: String, actor_id: String, operation: String) -> void
   end
 
   class UnknownCommitAction < NonRetryableError

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

@@ -36,14 +36,14 @@ module SolidObjects
     # @rbs (Array[Actor::CommitActionIntent]) -> void
     def execute_commit_actions: (Array[Actor::CommitActionIntent]) -> void
 
-    # @rbs (Actor::CommitActionIntent, Proc, CommitActionContext) -> untyped
-    def execute_commit_action: (Actor::CommitActionIntent, Proc, CommitActionContext) -> untyped
+    # @rbs (intent: Actor::CommitActionIntent, handler: Proc, context: CommitActionContext) -> untyped
+    def execute_commit_action: (intent: Actor::CommitActionIntent, handler: Proc, context: CommitActionContext) -> untyped
 
     # @rbs () -> void
     def ensure_application_database_is_shared!: () -> void
 
-    # @rbs (Message, Instance, Array[Actor::EffectIntent]) -> Array[Effect]
-    def enqueue_effects: (Message, Instance, Array[Actor::EffectIntent]) -> Array[Effect]
+    # @rbs (message: Message, instance: Instance, intents: Array[Actor::EffectIntent]) -> Array[Effect]
+    def enqueue_effects: (message: Message, instance: Instance, intents: Array[Actor::EffectIntent]) -> Array[Effect]
 
     # A reminder is one named alarm per actor, so scheduling a name that is
     # already armed moves it rather than adding a second. An actor that arms a
@@ -62,11 +62,11 @@ module SolidObjects
     # @rbs (Reminder, Time?) -> Hash[Symbol, untyped]?
     def moved_reminder_payload: (Reminder, Time?) -> Hash[Symbol, untyped]?
 
-    # @rbs (Message, Instance, Array[Actor::OutboundMessageIntent]) -> Array[Effect]
-    def enqueue_actor_messages: (Message, Instance, Array[Actor::OutboundMessageIntent]) -> Array[Effect]
+    # @rbs (message: Message, instance: Instance, intents: Array[Actor::OutboundMessageIntent]) -> Array[Effect]
+    def enqueue_actor_messages: (message: Message, instance: Instance, intents: Array[Actor::OutboundMessageIntent]) -> Array[Effect]
 
-    # @rbs (Message, Instance, Hash[String, untyped], state_changed: bool) -> void
-    def enqueue_broadcasts: (Message, Instance, Hash[String, untyped], state_changed: bool) -> void
+    # @rbs (message: Message, instance: Instance, observable_changes: Hash[String, untyped], state_changed: bool) -> void
+    def enqueue_broadcasts: (message: Message, instance: Instance, observable_changes: Hash[String, untyped], state_changed: bool) -> void
 
     # @rbs () -> bool
     def payload_broadcasts?: () -> bool
@@ -83,8 +83,8 @@ module SolidObjects
     # @rbs (Exception) -> Hash[String, untyped]
     def serialized_error: (Exception) -> Hash[String, untyped]
 
-    # @rbs (Message, Hash[String, untyped], Time) -> DeadLetter
-    def create_dead_letter: (Message, Hash[String, untyped], Time) -> DeadLetter
+    # @rbs (message: Message, error_details: Hash[String, untyped], now: Time) -> DeadLetter
+    def create_dead_letter: (message: Message, error_details: Hash[String, untyped], now: Time) -> DeadLetter
 
     # @rbs () -> Hash[Symbol, untyped]
     def instrumentation_payload: () -> Hash[Symbol, untyped]

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

@@ -8,8 +8,8 @@ module SolidObjects
     # @rbs (instance_id: Integer, owner_id: String, ?activation_token: String, ?duration: Numeric, ?database_adapter: DatabaseAdapter) -> Lease?
     def self.acquire: (instance_id: Integer, owner_id: String, ?activation_token: String, ?duration: Numeric, ?database_adapter: DatabaseAdapter) -> Lease?
 
-    # @rbs (Instance, String, Time) -> bool
-    private def self.held_by_another_live_owner?: (Instance, String, Time) -> bool
+    # @rbs (instance: Instance, activation_token: String, now: Time) -> bool
+    private def self.held_by_another_live_owner?: (instance: Instance, activation_token: String, now: Time) -> bool
 
     @database_adapter: DatabaseAdapter
 

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

@@ -9,11 +9,11 @@ module SolidObjects
     # @rbs (?database_adapter: DatabaseAdapter) -> void
     def initialize: (?database_adapter: DatabaseAdapter) -> void
 
-    # @rbs (Reference, Symbol | String, Hash[Symbol | String, untyped], kind: String, ?available_at: Time?, idempotency_key: String?) -> MessageReference
-    def enqueue: (Reference, Symbol | String, Hash[Symbol | String, untyped], kind: String, idempotency_key: String?, ?available_at: Time?) -> MessageReference
+    # @rbs (reference: Reference, operation: Symbol | String, arguments: Hash[Symbol | String, untyped], delivery_mode: String, ?available_at: Time?, idempotency_key: String?) -> MessageReference
+    def enqueue: (reference: Reference, operation: Symbol | String, arguments: Hash[Symbol | String, untyped], delivery_mode: String, idempotency_key: String?, ?available_at: Time?) -> MessageReference
 
-    # @rbs (Reference, Symbol | String, Hash[Symbol | String, untyped], kind: String, ?available_at: Time?, idempotency_key: String?, ?actor_class: Class?) -> Message
-    def enqueue_in_transaction: (Reference, Symbol | String, Hash[Symbol | String, untyped], kind: String, idempotency_key: String?, ?available_at: Time?, ?actor_class: Class?) -> Message
+    # @rbs (reference: Reference, operation: Symbol | String, arguments: Hash[Symbol | String, untyped], delivery_mode: String, ?available_at: Time?, idempotency_key: String?, ?actor_class: Class?) -> Message
+    def enqueue_in_transaction: (reference: Reference, operation: Symbol | String, arguments: Hash[Symbol | String, untyped], delivery_mode: String, idempotency_key: String?, ?available_at: Time?, ?actor_class: Class?) -> Message
 
     # @rbs (Message) -> void
     def announce: (Message) -> void
@@ -31,14 +31,14 @@ module SolidObjects
     # @rbs (Instance, String?) -> Message?
     def find_idempotent_message: (Instance, String?) -> Message?
 
-    # @rbs (Message, Symbol | String, String, untyped) -> Message
-    def validate_idempotent_message!: (Message, Symbol | String, String, untyped) -> Message
+    # @rbs (existing_message: Message, operation: Symbol | String, delivery_mode: String, arguments: untyped) -> Message
+    def validate_idempotent_message!: (existing_message: Message, operation: Symbol | String, delivery_mode: String, arguments: untyped) -> Message
 
     # @rbs (Instance) -> void
     def enforce_mailbox_limit!: (Instance) -> void
 
-    # @rbs (Instance, Reference, Symbol | String, untyped, kind: String, available_at: Time?, idempotency_key: String?) -> Message
-    def create_message: (Instance, Reference, Symbol | String, untyped, kind: String, available_at: Time?, idempotency_key: String?) -> Message
+    # @rbs (instance: Instance, reference: Reference, operation: Symbol | String, arguments: untyped, delivery_mode: String, available_at: Time?, idempotency_key: String?) -> Message
+    def create_message: (instance: Instance, reference: Reference, operation: Symbol | String, arguments: untyped, delivery_mode: String, available_at: Time?, idempotency_key: String?) -> Message
 
     # @rbs (Time?, Time) -> Time
     def normalize_availability: (Time?, Time) -> Time

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

@@ -0,0 +1,35 @@
+# Generated from lib/solid_objects/operation_dispatcher.rb with RBS::Inline
+
+module SolidObjects
+  class OperationDispatcher
+    @actor_type: String
+
+    @handlers: Hash[Symbol, ActorDefinition::Handler]
+
+    @dispatch: Proc
+
+    # @rbs (actor_type: String, handlers: Hash[Symbol, ActorDefinition::Handler]) { (Symbol, Hash[Symbol, untyped]) -> untyped } -> void
+    def initialize: (actor_type: String, handlers: Hash[Symbol, ActorDefinition::Handler]) { (Symbol, Hash[Symbol, untyped]) -> untyped } -> void
+
+    # @rbs (Symbol, *untyped, **untyped) -> untyped
+    def method_missing: (Symbol, *untyped, **untyped) -> untyped
+
+    # @rbs (Symbol, bool) -> bool
+    def respond_to_missing?: (Symbol, bool) -> bool
+
+    private
+
+    attr_reader actor_type: untyped
+
+    attr_reader handlers: untyped
+
+    attr_reader dispatch: untyped
+
+    RESERVED_REFERENCE_METHOD_NAMES: untyped
+
+    RESERVED_OPERATION_NAMES: untyped
+
+    # @rbs (Symbol | String) -> void
+    def self.validate_operation_name!: (Symbol | String) -> void
+  end
+end

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

@@ -13,11 +13,11 @@ module SolidObjects
     # @rbs (actor_type: String, actor_id: String) -> void
     def initialize: (actor_type: String, actor_id: String) -> void
 
-    # @rbs (Symbol | String, ?available_at: Time?, ?idempotency_key: String?, ?authorization_context: untyped, **untyped) -> MessageReference?
-    def async: (Symbol | String, ?available_at: Time?, ?idempotency_key: String?, ?authorization_context: untyped, **untyped) -> MessageReference?
+    # @rbs (?available_at: Time?, ?idempotency_key: String?, ?authorization_context: untyped) -> OperationDispatcher
+    def async: (?available_at: Time?, ?idempotency_key: String?, ?authorization_context: untyped) -> OperationDispatcher
 
-    # @rbs (Symbol | String, ?timeout: Numeric, ?idempotency_key: String?, ?authorization_context: untyped, **untyped) -> untyped
-    def sync: (Symbol | String, ?timeout: Numeric, ?idempotency_key: String?, ?authorization_context: untyped, **untyped) -> untyped
+    # @rbs (?timeout: Numeric, ?idempotency_key: String?, ?authorization_context: untyped) -> OperationDispatcher
+    def sync: (?timeout: Numeric, ?idempotency_key: String?, ?authorization_context: untyped) -> OperationDispatcher
 
     # @rbs (?authorization_context: untyped) -> bool
     def destroy: (?authorization_context: untyped) -> bool
@@ -36,6 +36,9 @@ module SolidObjects
 
     private
 
+    # @rbs (Symbol | String, Hash[Symbol, untyped], timeout: Numeric, idempotency_key: String?, authorization_context: untyped) -> untyped
+    def invoke_synchronously: (Symbol | String, Hash[Symbol, untyped], timeout: Numeric, idempotency_key: String?, authorization_context: untyped) -> untyped
+
     # @rbs (Symbol | String) -> bool
     def actor_message?: (Symbol | String) -> bool
 

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

@@ -36,6 +36,8 @@ module SolidObjects
 
     attr_reader threads: untyped
 
+    attr_reader builders: untyped
+
     # A role that raises leaves its thread dead. Without replacement the
     # process keeps running while quietly doing less work, so the supervisor
     # watches its threads and restarts any that stopped before shutdown.
@@ -101,8 +103,23 @@ module SolidObjects
     # @rbs () -> void
     def release_wake_up: () -> void
 
-    # @rbs (worker_count: Integer, effect_worker_count: Integer, broadcast_worker_count: Integer, reminder_scheduler_count: Integer) -> Array[Worker | EffectExecutor | ReminderScheduler | BroadcastExecutor]
-    def build_components: (worker_count: Integer, effect_worker_count: Integer, broadcast_worker_count: Integer, reminder_scheduler_count: Integer) -> Array[Worker | EffectExecutor | ReminderScheduler | BroadcastExecutor]
+    # A constructor can take a resource, and a later builder can raise. Without
+    # this, the components built first would be dropped while still holding
+    # whatever they took, and nothing would ever give it back.
+    # @rbs (Array[^() -> untyped]) -> Array[untyped]
+    def build_all: (Array[^() -> untyped]) -> Array[untyped]
+
+    # The failure that stopped the build is the one worth reporting, so a
+    # failure inside the cleanup never replaces it.
+    # @rbs (untyped) -> void
+    def stop_after_failed_build: (untyped) -> void
+
+    # Each component keeps the builder that made it, so a replacement after a
+    # crash is built the same way as the original. Components registered
+    # through the configuration run beside the built in ones, under the same
+    # supervision, restart, and shutdown timeout.
+    # @rbs (worker_count: Integer, effect_worker_count: Integer, broadcast_worker_count: Integer, reminder_scheduler_count: Integer) -> Array[^() -> untyped]
+    def component_builders: (worker_count: Integer, effect_worker_count: Integer, broadcast_worker_count: Integer, reminder_scheduler_count: Integer) -> Array[^() -> untyped]
 
     # @rbs () -> void
     def join_until_timeout: () -> void

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

@@ -19,8 +19,8 @@ module SolidObjects
     # @rbs (Message) -> String
     def message_status: (Message) -> String
 
-    # @rbs (Message, Instance, Message?) -> String
-    def waiting_reason: (Message, Instance, Message?) -> String
+    # @rbs (message: Message, instance: Instance, blocker: Message?) -> String
+    def waiting_reason: (message: Message, instance: Instance, blocker: Message?) -> String
 
     # @rbs (ReadyMessage?) -> bool
     def future?: (ReadyMessage?) -> bool

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

@@ -9,14 +9,14 @@ module SolidObjects
     # @rbs (Broadcast) -> String
     def self?.observable: (Broadcast) -> String
 
-    # @rbs (Reference, Symbol | String, untyped) -> String
-    def self?.observable_value: (Reference, Symbol | String, untyped) -> String
+    # @rbs (reference: Reference, name: Symbol | String, value: untyped) -> String
+    def self?.observable_value: (reference: Reference, name: Symbol | String, value: untyped) -> String
 
-    # @rbs (ComponentRegistration, Integer, Integer) -> String
-    def self?.component_refresh: (ComponentRegistration, Integer, Integer) -> String
+    # @rbs (registration: ComponentRegistration, instance_id: Integer, revision: Integer) -> String
+    def self?.component_refresh: (registration: ComponentRegistration, instance_id: Integer, revision: Integer) -> String
 
-    # @rbs (Array[ComponentRegistration], Integer, Integer) -> String
-    def self?.batch_refresh: (Array[ComponentRegistration], Integer, Integer) -> String
+    # @rbs (registrations: Array[ComponentRegistration], instance_id: Integer, revision: Integer) -> String
+    def self?.batch_refresh: (registrations: Array[ComponentRegistration], instance_id: Integer, revision: Integer) -> String
 
     # @rbs (Hash[String, untyped]) -> String
     def self?.state_payload: (Hash[String, untyped]) -> String
@@ -27,7 +27,7 @@ module SolidObjects
     # @rbs (untyped) -> String
     def self?.display_value: (untyped) -> String
 
-    # @rbs (ComponentRegistration, Integer, Integer) -> String
-    def self?.morph_component_refresh: (ComponentRegistration, Integer, Integer) -> String
+    # @rbs (registration: ComponentRegistration, instance_id: Integer, revision: Integer) -> String
+    def self?.morph_component_refresh: (registration: ComponentRegistration, instance_id: Integer, revision: Integer) -> String
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solid_objects
 version: !ruby/object:Gem::Version
-  version: 0.10.3
+  version: 0.12.0
 platform: ruby
 authors:
 - Lucas Carlson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-11 00:00:00.000000000 Z
+date: 2026-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actioncable
@@ -312,6 +312,7 @@ files:
 - config/routes.rb
 - db/migrate/20260805000000_create_solid_objects_tables.rb
 - db/migrate/20260806000000_add_state_revision_to_solid_objects_instances.rb
+- db/migrate/20260813000000_rename_message_dispatch_columns.rb
 - docs/adr/0001-postgresql-backend.md
 - docs/adr/0002-jsonb-actor-state.md
 - docs/adr/0003-mailbox-ordering.md
@@ -401,6 +402,7 @@ files:
 - lib/solid_objects/mailbox.rb
 - lib/solid_objects/message_pruner.rb
 - lib/solid_objects/message_reference.rb
+- lib/solid_objects/operation_dispatcher.rb
 - lib/solid_objects/payload_broadcast.rb
 - lib/solid_objects/process_pruner.rb
 - lib/solid_objects/process_registry.rb
@@ -476,6 +478,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/operation_dispatcher.rbs
 - sig/generated/lib/solid_objects/payload_broadcast.rbs
 - sig/generated/lib/solid_objects/process_pruner.rbs
 - sig/generated/lib/solid_objects/process_registry.rbs