solid_objects 0.5.2 → 0.7.0

data/lib/solid_objects/actor_definition.rb

@@ -9,6 +9,7 @@ module SolidObjects
     # @rbs @messages: Hash[Symbol, Handler]
     # @rbs @queries: Hash[Symbol, Handler]
     # @rbs @observables: Hash[Symbol, Handler]
+    # @rbs @payload_broadcasts: Hash[Symbol, Handler]
     # @rbs @state_version: Integer
     # @rbs @state_migrations: Array[StateMigration]
     # @rbs @activation_hooks: Array[Proc]
@@ -20,6 +21,7 @@ module SolidObjects
       :messages,
       :queries,
       :observables,
+      :payload_broadcasts,
       :state_version,
       :state_migrations,
       :activation_hooks,
@@ -31,6 +33,7 @@ module SolidObjects
       @messages = {}
       @queries = {}
       @observables = {}
+      @payload_broadcasts = {}
       @state_version = 1
       @state_migrations = []
       @activation_hooks = []
@@ -83,6 +86,21 @@ module SolidObjects
       end
     end
 
+    # @rbs (Symbol | String, Proc) -> Handler
+    def add_payload_broadcast(name, block)
+      payload_name = name.to_sym
+      if payload_broadcasts.key?(payload_name)
+        raise InvalidActor, "#{payload_name.inspect} payload broadcast is already defined"
+      end
+      unless payload_name.to_s.match?(/\A[a-zA-Z0-9_]+\z/)
+        raise InvalidActor, "payload broadcast names may contain only letters, digits, and underscores"
+      end
+
+      Handler.new(name: payload_name, block:).tap do |handler|
+        payload_broadcasts[payload_name] = handler
+      end
+    end
+
     # @rbs (Class) -> ActorDefinition
     def synchronize_instance_messages(actor_class)
       names = actor_message_method_names(actor_class)
@@ -149,6 +167,7 @@ module SolidObjects
         copy.instance_variable_set(:@messages, messages.dup)
         copy.instance_variable_set(:@queries, queries.dup)
         copy.instance_variable_set(:@observables, observables.dup)
+        copy.instance_variable_set(:@payload_broadcasts, payload_broadcasts.dup)
         copy.instance_variable_set(:@state_version, state_version)
         copy.instance_variable_set(:@state_migrations, state_migrations.dup)
         copy.instance_variable_set(:@activation_hooks, activation_hooks.dup)

data/lib/solid_objects/actor_view.rb

@@ -37,18 +37,19 @@ module SolidObjects
       )
     end
 
-    # @rbs (Symbol | String, ?observes: Symbol | String | Array[Symbol | String]?, ?partial: String?, ?key: untyped, ?locals: Hash[untyped, untyped], ?refresh: String | Symbol) -> untyped
+    # @rbs (Symbol | String, ?observes: Symbol | String | Array[Symbol | String]?, ?partial: String?, ?key: untyped, ?locals: Hash[untyped, untyped], ?refresh: String | Symbol, ?batch: untyped) -> untyped
     def component(
       name,
       observes: nil,
       partial: nil,
       key: nil,
       locals: {},
-      refresh: :replace
+      refresh: :replace,
+      batch: nil
     )
       component_name = normalized_component_name(name)
       unless observes
-        validate_static_options!(key:, locals:, refresh:)
+        validate_static_options!(key:, locals:, refresh:, batch:)
         return static_component(component_name, partial:)
       end
       if partial
@@ -67,7 +68,8 @@ module SolidObjects
         locals:,
         refresh_method: refresh,
         snapshot:,
-        refresh_path:
+        refresh_path:,
+        batch: batch&.to_s
       )
       ensure_unique_component!(registration)
       rendered = ComponentRenderer.new(
@@ -98,6 +100,11 @@ module SolidObjects
       observable_names.dup
     end
 
+    # @rbs () -> bool
+    def batched_components?
+      component_registrations.any?(&:batch)
+    end
+
     # @rbs () -> bool
     def morph_components?
       component_registrations.any?(&:morph?)
@@ -212,9 +219,9 @@ module SolidObjects
           "#{registration.component_key.inspect} is already rendered in this solid_object scope"
     end
 
-    # @rbs (key: untyped, locals: Hash[untyped, untyped], refresh: String | Symbol) -> void
-    def validate_static_options!(key:, locals:, refresh:)
-      return if key.nil? && locals.empty? && refresh.to_s == "replace"
+    # @rbs (key: untyped, locals: Hash[untyped, untyped], refresh: String | Symbol, batch: untyped) -> void
+    def validate_static_options!(key:, locals:, refresh:, batch:)
+      return if key.nil? && locals.empty? && refresh.to_s == "replace" && batch.nil?
 
       raise ArgumentError,
         "key, locals, and refresh require an observable component"

data/lib/solid_objects/component_registration.rb

@@ -7,6 +7,7 @@ module SolidObjects
     # @rbs @reference: Reference
     # @rbs @component_name: String
     # @rbs @component_key: String | Integer?
+    # @rbs @batch: String?
     # @rbs @dependencies: Array[String]
     # @rbs @locals: Hash[String, untyped]
     # @rbs @refresh_method: String
@@ -18,6 +19,7 @@ module SolidObjects
     attr_reader :reference,
       :component_name,
       :component_key,
+      :batch,
       :dependencies,
       :locals,
       :refresh_method,
@@ -26,7 +28,7 @@ module SolidObjects
       :refresh_path,
       :token
 
-    # @rbs (reference: Reference, component_name: String, component_key: String | Integer?, dependencies: Array[String], locals: Hash[String, untyped], refresh_method: String, instance_id: Integer, revision: Integer, refresh_path: String, token: String) -> void
+    # @rbs (reference: Reference, component_name: String, component_key: String | Integer?, dependencies: Array[String], locals: Hash[String, untyped], refresh_method: String, instance_id: Integer, revision: Integer, refresh_path: String, token: String, ?batch: String?) -> void
     def initialize(
       reference:,
       component_name:,
@@ -37,9 +39,11 @@ module SolidObjects
       instance_id:,
       revision:,
       refresh_path:,
-      token:
+      token:,
+      batch: nil
     )
       @reference = reference
+      @batch = batch
       @component_name = component_name
       @component_key = component_key
       @dependencies = dependencies.freeze
@@ -52,7 +56,7 @@ module SolidObjects
     end
 
     class << self
-      # @rbs (reference: Reference, component_name: String, component_key: untyped, dependencies: Array[String], locals: Hash[untyped, untyped], refresh_method: String | Symbol, snapshot: ActorSnapshot, refresh_path: String) -> ComponentRegistration
+      # @rbs (reference: Reference, component_name: String, component_key: untyped, dependencies: Array[String], locals: Hash[untyped, untyped], refresh_method: String | Symbol, snapshot: ActorSnapshot, refresh_path: String, ?batch: String?) -> ComponentRegistration
       def issue(
         reference:,
         component_name:,
@@ -61,7 +65,8 @@ module SolidObjects
         locals:,
         refresh_method:,
         snapshot:,
-        refresh_path:
+        refresh_path:,
+        batch: nil
       )
         token = ComponentToken.generate(
           reference:,
@@ -70,6 +75,7 @@ module SolidObjects
           dependencies:,
           locals:,
           refresh_method:,
+          batch:,
           instance_id: snapshot.instance_id,
           revision: snapshot.revision,
           refresh_path:
@@ -99,6 +105,7 @@ module SolidObjects
           reference:,
           component_name: payload.fetch("component_name"),
           component_key: payload["component_key"],
+          batch: payload["batch"],
           dependencies:,
           locals: payload.fetch("locals"),
           refresh_method: payload.fetch("refresh_method"),
@@ -149,6 +156,18 @@ module SolidObjects
       locals.merge("component_key" => component_key).freeze
     end
 
+    # @rbs (Array[ComponentRegistration], Integer, Integer) -> String
+    def batch_refresh_url(registrations, instance_id, revision)
+      query = URI.encode_www_form(
+        [
+          [ "instance_id", instance_id ],
+          [ "revision", revision ],
+          *registrations.map { |registration| [ "tokens[]", registration.token ] }
+        ]
+      )
+      "#{refresh_path}/batch?#{query}"
+    end
+
     # @rbs (Integer, Integer) -> String
     def refresh_url(instance_id, revision)
       query = URI.encode_www_form(

data/lib/solid_objects/component_subscriptions.rb

@@ -48,16 +48,17 @@ module SolidObjects
       observable_name = invalidation.fetch("observable_name")
       instance_id = invalidation.fetch("instance_id")
       revision = invalidation.fetch("revision")
-      registrations.filter_map do |registration|
-        next unless registration.dependencies.include?(observable_name)
-        next unless newer_revision?(
-          registration.dom_id,
-          instance_id,
-          revision
-        )
-
-        refresh(registration, instance_id, revision)
+      changed = registrations.select do |registration|
+        registration.dependencies.include?(observable_name) &&
+          newer_revision?(registration.dom_id, instance_id, revision)
       end
+      batched, individual = changed.partition(&:batch)
+      streams = individual.map { |registration| refresh(registration, instance_id, revision) }
+      batched.group_by(&:batch).each_value do |group|
+        group.each { |registration| record_revision(registration, instance_id, revision) }
+        streams << TurboStreamRenderer.batch_refresh(group, instance_id, revision)
+      end
+      streams
     end
 
     # @rbs (ActorSnapshot) -> Array[String]
@@ -90,9 +91,14 @@ module SolidObjects
 
     attr_reader :registrations, :revisions
 
+    # @rbs (ComponentRegistration, Integer, Integer) -> void
+    def record_revision(registration, instance_id, revision)
+      revisions[registration.dom_id] = [ instance_id, revision ]
+    end
+
     # @rbs (ComponentRegistration, Integer, Integer) -> String
     def refresh(registration, instance_id, revision)
-      revisions[registration.dom_id] = [ instance_id, revision ]
+      record_revision(registration, instance_id, revision)
       TurboStreamRenderer.component_refresh(
         registration,
         instance_id,

data/lib/solid_objects/component_token.rb

@@ -9,6 +9,7 @@ module SolidObjects
     MAXIMUM_DEPENDENCIES = 50
     MAXIMUM_LOCALS = 50
     MAXIMUM_COMPONENT_KEY_BYTES = 512
+    MAXIMUM_BATCH_BYTES = 64
     REFRESH_METHODS = %w[replace morph].freeze
     RESERVED_LOCALS = %w[actor authorization_context component_key].freeze
     RUBY_KEYWORDS = %w[
@@ -19,7 +20,7 @@ module SolidObjects
 
     module_function
 
-    # @rbs (reference: Reference, component_name: String, dependencies: Array[String], instance_id: Integer, revision: Integer, refresh_path: String, ?component_key: untyped, ?locals: Hash[untyped, untyped], ?refresh_method: String | Symbol) -> String
+    # @rbs (reference: Reference, component_name: String, dependencies: Array[String], instance_id: Integer, revision: Integer, refresh_path: String, ?component_key: untyped, ?locals: Hash[untyped, untyped], ?refresh_method: String | Symbol, ?batch: untyped) -> String
     def generate(
       reference:,
       component_name:,
@@ -29,13 +30,15 @@ module SolidObjects
       refresh_path:,
       component_key: nil,
       locals: {},
-      refresh_method: "replace"
+      refresh_method: "replace",
+      batch: nil
     )
       payload = {
         "actor_type" => reference.actor_type,
         "actor_id" => reference.actor_id,
         "component_name" => component_name,
         "component_key" => Serialization.dump(component_key),
+        "batch" => batch&.to_s,
         "dependencies" => dependencies,
         "locals" => Serialization.dump(locals),
         "refresh_method" => refresh_method.to_s,
@@ -80,6 +83,7 @@ module SolidObjects
 
       validate_component_name!(payload.fetch("component_name"))
       validate_component_key!(payload["component_key"])
+      validate_batch!(payload["batch"])
       validate_dependencies!(payload.fetch("dependencies"))
       validate_locals!(payload.fetch("locals"))
       validate_refresh_method!(payload.fetch("refresh_method"))
@@ -97,6 +101,7 @@ module SolidObjects
       return unless payload.is_a?(Hash)
 
       payload["component_key"] = nil unless payload.key?("component_key")
+      payload["batch"] = nil unless payload.key?("batch")
       payload["locals"] = {} unless payload.key?("locals")
       payload["refresh_method"] = "replace" unless payload.key?("refresh_method")
     end
@@ -124,6 +129,18 @@ module SolidObjects
     end
     private_class_method :validate_component_key!
 
+    # @rbs (untyped) -> void
+    def validate_batch!(batch)
+      return if batch.nil?
+      return if batch.is_a?(String) &&
+        batch.bytesize.positive? &&
+        batch.bytesize <= MAXIMUM_BATCH_BYTES &&
+        batch.match?(/\A[a-zA-Z0-9_]+\z/)
+
+      raise InvalidComponentToken, "invalid actor component batch"
+    end
+    private_class_method :validate_batch!
+
     # @rbs (Array[untyped]) -> void
     def validate_dependencies!(dependencies)
       valid = dependencies.any? &&

data/lib/solid_objects/errors.rb

@@ -43,6 +43,12 @@ module SolidObjects
   class UnknownComponent < Error
   end
 
+  class UnknownPayloadBroadcast < Error
+  end
+
+  class InvalidPayloadBroadcast < Error
+  end
+
   class UnknownComponentDependency < Error
   end
 

data/lib/solid_objects/executor.rb

@@ -27,7 +27,7 @@ module SolidObjects
       result = invoke_actor(message_context)
       ensure_query_did_not_mutate_state!(state_before)
       observable_changes = changed_observables(observables_before, actor.observable_values)
-      complete(result, observable_changes)
+      complete(result, observable_changes, state_changed: actor.state.to_h != state_before)
       true
     rescue LostActivation
       raise
@@ -75,8 +75,8 @@ module SolidObjects
       end
     end
 
-    # @rbs (untyped, Hash[String, untyped]) -> void
-    def complete(result, observable_changes)
+    # @rbs (untyped, Hash[String, untyped], state_changed: bool) -> void
+    def complete(result, observable_changes, state_changed:)
       serialized_state = Serialization.dump(
         actor.state.to_h,
         max_bytes: SolidObjects.configuration.max_state_bytes
@@ -111,7 +111,12 @@ module SolidObjects
         enqueued_effects.concat(
           enqueue_actor_messages(locked_message, instance, outbound_message_intents)
         )
-        enqueue_broadcasts(locked_message, instance, observable_changes)
+        enqueue_broadcasts(
+          locked_message,
+          instance,
+          observable_changes,
+          state_changed:
+        )
         claimed_message.destroy!
       end
 
@@ -249,9 +254,14 @@ module SolidObjects
       end
     end
 
-    # @rbs (Message, Instance, Hash[String, untyped]) -> void
-    def enqueue_broadcasts(locked_message, instance, observable_changes)
-      observable_changes.each do |observable_name, value|
+    # @rbs (Message, Instance, Hash[String, untyped], state_changed: bool) -> void
+    def enqueue_broadcasts(locked_message, instance, observable_changes, state_changed:)
+      broadcasts = observable_changes
+      if broadcasts.empty? && state_changed && payload_broadcasts?
+        broadcasts = { PayloadBroadcast::REVISION_OBSERVABLE => {} }
+      end
+
+      broadcasts.each do |observable_name, value|
         Broadcast.create!(
           message: locked_message,
           instance:,
@@ -266,6 +276,11 @@ module SolidObjects
       end
     end
 
+    # @rbs () -> bool
+    def payload_broadcasts?
+      actor.class.definition.payload_broadcasts.any?
+    end
+
     # @rbs (Exception) -> void
     def fail_message(error)
       error_details = serialized_error(error)

data/lib/solid_objects/payload_broadcast.rb

@@ -0,0 +1,67 @@
+# rbs_inline: enabled
+
+module SolidObjects
+  class PayloadBroadcast
+    MAXIMUM_PAYLOAD_BYTES = 1_048_576
+    REVISION_OBSERVABLE = "solid_objects.revision"
+
+    # @rbs @snapshot: ActorSnapshot
+    # @rbs @name: String
+    # @rbs @authorization_context: untyped
+
+    attr_reader :name
+
+    # @rbs (snapshot: ActorSnapshot, name: String, authorization_context: untyped) -> void
+    def initialize(snapshot:, name:, authorization_context:)
+      @snapshot = snapshot
+      @name = name
+      @authorization_context = authorization_context
+    end
+
+    # @rbs () -> Hash[String, untyped]
+    def call
+      handler = snapshot.actor_class.definition.payload_broadcasts[name.to_sym]
+      raise UnknownPayloadBroadcast, "unknown payload broadcast #{name.inspect}" unless handler
+
+      authorize!
+      {
+        "actor_type" => snapshot.reference.actor_type,
+        "actor_id" => snapshot.reference.actor_id,
+        "name" => name,
+        "instance_id" => snapshot.instance_id,
+        "revision" => snapshot.revision,
+        "payload" => rendered_payload(handler)
+      }
+    end
+
+    private
+
+    attr_reader :snapshot, :authorization_context
+
+    # @rbs (ActorDefinition::Handler) -> untyped
+    def rendered_payload(handler)
+      payload = Serialization.dump(
+        handler.block.call(snapshot.actor, authorization_context),
+        max_bytes: MAXIMUM_PAYLOAD_BYTES
+      )
+      return payload if payload.is_a?(Hash) || payload.is_a?(Array)
+
+      raise InvalidPayloadBroadcast,
+        "payload broadcast #{name.inspect} must return a JSON object or array"
+    end
+
+    # @rbs () -> void
+    def authorize!
+      authorized = SolidObjects.configuration.authorize_query.call(
+        actor_type: snapshot.reference.actor_type,
+        actor_id: snapshot.reference.actor_id,
+        message_name: name,
+        arguments: {},
+        authorization_context:
+      )
+      return if authorized
+
+      raise Unauthorized, "actor payload broadcast is not authorized"
+    end
+  end
+end

data/lib/solid_objects/stream_token.rb

@@ -9,13 +9,14 @@ module SolidObjects
 
     module_function
 
-    # @rbs (Reference, ?observables: Array[String]?) -> String
-    def generate(reference, observables: nil)
+    # @rbs (Reference, ?observables: Array[String]?, ?payloads: Array[String]?) -> String
+    def generate(reference, observables: nil, payloads: nil)
       identity = {
         "actor_type" => reference.actor_type,
         "actor_id" => reference.actor_id
       }
       identity["observables"] = observables if observables
+      identity["payloads"] = payloads if payloads
       validate_identity!(identity)
       verifier.generate(identity, purpose: PURPOSE)
     end
@@ -36,21 +37,27 @@ module SolidObjects
         raise InvalidStreamToken, "invalid actor stream token"
       end
 
-      observables = identity["observables"]
-      return identity unless observables
+      validate_names!(identity["observables"], "observables")
+      validate_names!(identity["payloads"], "payloads")
+      identity
+    end
+
+    # @rbs (untyped, String) -> void
+    def validate_names!(names, label)
+      return unless names
 
-      valid = observables.is_a?(Array) &&
-        observables.length <= MAXIMUM_OBSERVABLES &&
-        observables.uniq.length == observables.length &&
-        observables.all? do |observable|
-          observable.is_a?(String) &&
-            observable.match?(/\A[a-zA-Z0-9_]+\z/)
+      valid = names.is_a?(Array) &&
+        names.length <= MAXIMUM_OBSERVABLES &&
+        names.uniq.length == names.length &&
+        names.all? do |name|
+          name.is_a?(String) && name.match?(/\A[a-zA-Z0-9_]+\z/)
         end
-      return identity if valid
+      return if valid
 
-      raise InvalidStreamToken, "invalid actor stream observables"
+      raise InvalidStreamToken, "invalid actor stream #{label}"
     end
     private_class_method :validate_identity!
+    private_class_method :validate_names!
 
     # @rbs () -> ActiveSupport::MessageVerifier
     def verifier

data/lib/solid_objects/turbo_stream_renderer.rb

@@ -16,11 +16,15 @@ module SolidObjects
         actor_type: broadcast.instance.actor_type,
         actor_id: broadcast.instance.actor_id
       )
-      stream = observable_value(
-        reference,
-        broadcast.observable_name,
-        broadcast.value
-      )
+      stream = if broadcast.observable_name == PayloadBroadcast::REVISION_OBSERVABLE
+        ""
+      else
+        observable_value(
+          reference,
+          broadcast.observable_name,
+          broadcast.value
+        )
+      end
       metadata = Base64.urlsafe_encode64(
         JSON.generate(
           "instance_id" => broadcast.instance_id,
@@ -50,6 +54,31 @@ module SolidObjects
       %(<turbo-stream action="replace" target="#{target}"><template><turbo-frame id="#{target}" src="#{source}" data-solid-objects-revision="#{revision_value}" data-solid-objects-refresh="replace"></turbo-frame></template></turbo-stream>)
     end
 
+    # @rbs (Array[ComponentRegistration], Integer, Integer) -> String
+    def batch_refresh(registrations, instance_id, revision)
+      first = registrations.first
+      scope = DomIdentity.scope(first.reference)
+      batch = ERB::Util.html_escape(first.batch)
+      source = ERB::Util.html_escape(
+        first.batch_refresh_url(registrations, instance_id, revision)
+      )
+      targets = ERB::Util.html_escape(registrations.map(&:dom_id).join(" "))
+      %(<turbo-stream action="append" target="#{scope}"><template><solid-objects-batch-refresh data-batch="#{batch}" data-revision="#{instance_id}:#{revision}" data-targets="#{targets}" data-source="#{source}"></solid-objects-batch-refresh></template></turbo-stream>)
+    end
+
+    # @rbs (Hash[String, untyped]) -> String
+    def state_payload(payload)
+      reference = Reference.new(
+        actor_type: payload.fetch("actor_type"),
+        actor_id: payload.fetch("actor_id")
+      )
+      scope = DomIdentity.scope(reference)
+      name = ERB::Util.html_escape(payload.fetch("name"))
+      revision = "#{payload.fetch("instance_id")}:#{payload.fetch("revision")}"
+      body = ERB::Util.html_escape(JSON.generate(payload.fetch("payload")))
+      %(<turbo-stream action="append" target="#{scope}"><template><solid-objects-payload data-name="#{name}" data-revision="#{revision}">#{body}</solid-objects-payload></template></turbo-stream>)
+    end
+
     # @rbs (String) -> Hash[String, untyped]?
     def invalidation(stream)
       encoded = stream[INVALIDATION_PATTERN, 1]

data/lib/solid_objects/version.rb

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

data/lib/solid_objects.rb

@@ -40,6 +40,7 @@ require "solid_objects/component_registration"
 require "solid_objects/component_subscriptions"
 require "solid_objects/component_view"
 require "solid_objects/component_renderer"
+require "solid_objects/payload_broadcast"
 require "solid_objects/state_snapshot"
 require "solid_objects/actor_view"
 require "solid_objects/actor_channel"

data/sig/generated/controllers/solid_objects/components_controller.rbs

@@ -2,11 +2,22 @@
 
 module SolidObjects
   class ComponentsController < ActionController::Base
+    BATCH_LIMIT: ::Integer
+
     # @rbs () -> void
     def show: () -> void
 
+    # @rbs () -> void
+    def batch: () -> void
+
     private
 
+    # @rbs (Hash[Symbol, untyped]) -> void
+    def refresh_batch: (Hash[Symbol, untyped]) -> void
+
+    # @rbs (Array[ComponentRegistration]) -> void
+    def validate_single_batch!: (Array[ComponentRegistration]) -> void
+
     # @rbs (Hash[Symbol, untyped]) -> void
     def refresh: (Hash[Symbol, untyped]) -> void
 

data/sig/generated/helpers/solid_objects/actor_helper.rbs

@@ -2,7 +2,7 @@
 
 module SolidObjects
   module ActorHelper
-    # @rbs (Reference, ?authorization_context: untyped) { (ActorView) -> untyped } -> untyped
-    def solid_object: (Reference, ?authorization_context: untyped) { (ActorView) -> untyped } -> untyped
+    # @rbs (Reference, ?authorization_context: untyped, ?payloads: untyped) { (ActorView) -> untyped } -> untyped
+    def solid_object: (Reference, ?authorization_context: untyped, ?payloads: untyped) { (ActorView) -> untyped } -> untyped
   end
 end

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

@@ -90,6 +90,9 @@ module SolidObjects
     # @rbs (Symbol | String) ?{ () -> untyped } -> ActorDefinition::Handler
     def self.observable: (Symbol | String) ?{ () -> untyped } -> ActorDefinition::Handler
 
+    # @rbs (Symbol | String) { (untyped, untyped) -> untyped } -> ActorDefinition::Handler
+    def self.broadcast_payload: (Symbol | String) { (untyped, untyped) -> untyped } -> ActorDefinition::Handler
+
     # @rbs (?Integer) -> Integer
     def self.state_version: (?Integer) -> Integer
 

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

@@ -13,9 +13,20 @@ module SolidObjects
 
     attr_reader scalar_observables: untyped
 
+    attr_reader payload_names: untyped
+
     # @rbs (String) -> void
     def receive_broadcast: (String) -> void
 
+    # @rbs (ActorSnapshot) -> void
+    def transmit_state_payloads: (ActorSnapshot) -> void
+
+    # @rbs (ActorSnapshot) -> bool
+    def newer_payload_revision?: (ActorSnapshot) -> bool
+
+    # @rbs () -> void
+    def validate_payload_names!: () -> void
+
     # @rbs (ActorSnapshot) -> void
     def refresh_outdated_components: (ActorSnapshot) -> void
 

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

@@ -42,6 +42,8 @@ module SolidObjects
 
     @state_version: Integer
 
+    @payload_broadcasts: Hash[Symbol, Handler]
+
     @observables: Hash[Symbol, Handler]
 
     @queries: Hash[Symbol, Handler]
@@ -58,6 +60,8 @@ module SolidObjects
 
     attr_reader observables: untyped
 
+    attr_reader payload_broadcasts: untyped
+
     attr_reader state_version: untyped
 
     attr_reader state_migrations: untyped
@@ -81,6 +85,9 @@ module SolidObjects
     # @rbs (Symbol | String, Proc?) -> Handler
     def add_observable: (Symbol | String, Proc?) -> Handler
 
+    # @rbs (Symbol | String, Proc) -> Handler
+    def add_payload_broadcast: (Symbol | String, Proc) -> Handler
+
     # @rbs (Class) -> ActorDefinition
     def synchronize_instance_messages: (Class) -> ActorDefinition