solid_objects 0.15.2 → 0.16.0

data/lib/solid_objects.rb

@@ -26,7 +26,14 @@ require "solid_objects/actor_definition"
 require "solid_objects/application_write_guard"
 require "solid_objects/actor"
 require "solid_objects/reference"
+require "solid_objects/outcome"
 require "solid_objects/message_reference"
+require "solid_objects/administration_audit"
+require "solid_objects/redrive_task"
+require "solid_objects/redrive_manager"
+require "solid_objects/redrive_runner"
+require "solid_objects/dead_row"
+require "solid_objects/dead_letter_scope"
 require "solid_objects/dead_letter_manager"
 require "solid_objects/message_pruner"
 require "solid_objects/instance_pruner"
@@ -49,6 +56,7 @@ require "solid_objects/actor_view"
 require "solid_objects/actor_channel"
 require "solid_objects/action_cable_broadcast_adapter"
 require "solid_objects/database_adapter"
+require "solid_objects/wake_up_capability"
 require "solid_objects/wake_up"
 require "solid_objects/wake_up_adapters/postgresql"
 require "solid_objects/wake_up_adapters/redis"
@@ -78,6 +86,8 @@ require "solid_objects/engine" if defined?(Rails::Engine)
 module SolidObjects
   extend Instrumentation
 
+  @wake_up_mutex = Thread::Mutex.new
+
   class << self
     # @rbs () -> Configuration
     def configuration
@@ -157,6 +167,11 @@ module SolidObjects
       @dead_letters ||= DeadLetterManager.new
     end
 
+    # @rbs () -> RedriveManager
+    def redrives
+      @redrives ||= RedriveManager.new
+    end
+
     # @rbs () -> Administration
     def administration
       @administration ||= Administration.new
@@ -180,15 +195,16 @@ module SolidObjects
     # @rbs () -> void
     def reset!
       ProcessRegistry.reset_polling_warning! if defined?(ProcessRegistry)
+      reset_wake_up!
       @configuration = Configuration.new
       @registry = ActorRegistry.new
       @client = nil
       @database_adapter = nil
-      @wake_up = nil
       @caller_process = nil
       @effect_registry = EffectRegistry.new
       @commit_action_registry = CommitActionRegistry.new
       @dead_letters = nil
+      @redrives = nil
       @administration = nil
     end
 
@@ -198,9 +214,36 @@ module SolidObjects
       @database_adapter ||= DatabaseAdapter.for(SolidObjects::Record.connection)
     end
 
-    # @rbs () -> WakeUp
+    # @rbs () -> untyped
     def wake_up
-      @wake_up ||= configuration.wake_up_adapter || WakeUp.new
+      @wake_up || @wake_up_mutex.synchronize { @wake_up ||= resolve_wake_up }
+    end
+
+    # @rbs () -> void
+    def reset_wake_up!
+      @wake_up_mutex.synchronize { @wake_up = nil }
+      WakeUpAdapters.reset_pooled_warning!
+    end
+
+    # @rbs () -> untyped
+    def resolve_wake_up
+      WakeUpAdapters.build(configuration.wake_up_adapter)
+    rescue ArgumentError
+      raise
+    rescue ActiveRecord::ActiveRecordError, SystemCallError, IOError => error
+      unreachable_wake_up(error)
+    end
+
+    # @rbs (Exception) -> untyped
+    def unreachable_wake_up(error)
+      adapter = WakeUp.new
+      adapter.capability = WakeUpCapability.new(
+        adapter: :in_process,
+        crosses_processes: false,
+        measured_floor_ms: nil,
+        reason: "the database could not be reached to select an adapter: #{error.class}"
+      )
+      adapter
     end
   end
 end

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

@@ -10,6 +10,10 @@ module SolidObjects
 
     @actor_class: Class
 
+    @instance_id: Integer
+
+    @actor_id: String
+
     @lease: Lease
 
     attr_reader lease: untyped
@@ -59,6 +63,9 @@ module SolidObjects
     # @rbs (Instance) -> Actor
     def build_actor: (Instance) -> Actor
 
+    # @rbs (Hash[String, untyped]) -> Actor
+    def new_actor: (Hash[String, untyped]) -> Actor
+
     # @rbs () -> void
     def release_lease: () -> void
 

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

@@ -58,6 +58,8 @@ module SolidObjects
 
     REMINDER_KEY_SEPARATOR: ::String
 
+    REMINDER_HANDLE_KEY: ::String
+
     class ReminderIntent < Data
       attr_reader name(): untyped
 
@@ -79,6 +81,55 @@ module SolidObjects
       def members: () -> [ :name, :operation, :at, :arguments, :interval_seconds, :missed_policy ]
     end
 
+    class UnscheduleIntent < Data
+      attr_reader name(): untyped
+
+      def self.new: (untyped name) -> instance
+                  | (name: untyped) -> instance
+
+      def self.members: () -> [ :name ]
+
+      def members: () -> [ :name ]
+    end
+
+    class UnscheduleAllIntent < Data
+      attr_reader operation(): untyped
+
+      def self.new: (untyped operation) -> instance
+                  | (operation: untyped) -> instance
+
+      def self.members: () -> [ :operation ]
+
+      def members: () -> [ :operation ]
+    end
+
+    class ReminderStatus < Data
+      attr_reader name(): untyped
+
+      attr_reader operation(): untyped
+
+      attr_reader key(): untyped
+
+      attr_reader next_run_at(): untyped
+
+      attr_reader interval_seconds(): untyped
+
+      attr_reader missed_policy(): untyped
+
+      attr_reader occurrence(): untyped
+
+      attr_reader status(): untyped
+
+      attr_reader handle(): untyped
+
+      def self.new: (untyped name, untyped operation, untyped key, untyped next_run_at, untyped interval_seconds, untyped missed_policy, untyped occurrence, untyped status, untyped handle) -> instance
+                  | (name: untyped, operation: untyped, key: untyped, next_run_at: untyped, interval_seconds: untyped, missed_policy: untyped, occurrence: untyped, status: untyped, handle: untyped) -> instance
+
+      def self.members: () -> [ :name, :operation, :key, :next_run_at, :interval_seconds, :missed_policy, :occurrence, :status, :handle ]
+
+      def members: () -> [ :name, :operation, :key, :next_run_at, :interval_seconds, :missed_policy, :occurrence, :status, :handle ]
+    end
+
     class OutboundMessageIntent < Data
       attr_reader actor_type(): untyped
 
@@ -172,8 +223,8 @@ module SolidObjects
 
     attr_reader state: untyped
 
-    # @rbs (actor_id: String, state: State) -> void
-    def initialize: (actor_id: String, state: State) -> void
+    # @rbs (actor_id: String, state: State, ?instance_id: Integer?) -> void
+    def initialize: (actor_id: String, state: State, ?instance_id: Integer?) -> void
 
     # @rbs () -> MessageContext?
     def current_message: () -> MessageContext?
@@ -201,6 +252,46 @@ module SolidObjects
     # @rbs (at: Time, ?every: Numeric?, ?missed: Symbol | String, ?key: (String | Symbol | Integer)?) -> OperationDispatcher
     def schedule: (at: Time, ?every: Numeric?, ?missed: Symbol | String, ?key: (String | Symbol | Integer)?) -> OperationDispatcher
 
+    # @rbs (Symbol | String | reminder_handle, ?key: (String | Symbol | Integer)?) -> nil
+    def unschedule: (Symbol | String | reminder_handle, ?key: (String | Symbol | Integer)?) -> nil
+
+    # @rbs (Symbol | String) -> nil
+    def unschedule_all: (Symbol | String) -> nil
+
+    # @rbs (Symbol | String | reminder_handle, ?key: (String | Symbol | Integer)?) -> ReminderStatus?
+    def reminder: (Symbol | String | reminder_handle, ?key: (String | Symbol | Integer)?) -> ReminderStatus?
+
+    # @rbs (Symbol | String) -> Array[ReminderStatus]
+    def reminders: (Symbol | String) -> Array[ReminderStatus]
+
+    attr_reader instance_id: untyped
+
+    # @rbs (Symbol | String) -> String
+    def validated_reminder_operation: (Symbol | String) -> String
+
+    # @rbs (String) -> nil
+    def unschedule_name: (String) -> nil
+
+    # @rbs (reminder_handle, key: untyped) -> String
+    def handle_name: (reminder_handle, key: untyped) -> String
+
+    # The view is the committed schedule with this turn's staged intents applied
+    # in order, so a read agrees with what the commit will leave behind.
+    # @rbs () -> Hash[String, ReminderStatus]
+    def reminder_view: () -> Hash[String, ReminderStatus]
+
+    # @rbs () -> Hash[String, ReminderStatus]
+    def committed_reminders: () -> Hash[String, ReminderStatus]
+
+    # @rbs (Hash[String, ReminderStatus], untyped) -> void
+    def apply_reminder_intent: (Hash[String, ReminderStatus], untyped) -> void
+
+    # @rbs (name: String, operation: String, next_run_at: Time?, interval_seconds: untyped, missed_policy: String, occurrence: Integer, status: String) -> ReminderStatus
+    def reminder_status: (name: String, operation: String, next_run_at: Time?, interval_seconds: untyped, missed_policy: String, occurrence: Integer, status: String) -> ReminderStatus
+
+    # @rbs (name: String, operation: String) -> String?
+    def reminder_key_of: (name: String, operation: String) -> String?
+
     # @rbs ((String | Symbol | Integer)?) -> String?
     def validated_reminder_key: ((String | Symbol | Integer)?) -> String?
 

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

@@ -0,0 +1,11 @@
+# Generated from lib/solid_objects/administration_audit.rb with RBS::Inline
+
+module SolidObjects
+  module AdministrationAudit
+    # @rbs (action: String, kind: String, ?subject_id: untyped, ?filters: Hash[Symbol | String, untyped]?, ?actor: String?) -> void
+    def self?.record: (action: String, kind: String, ?subject_id: untyped, ?filters: Hash[Symbol | String, untyped]?, ?actor: String?) -> void
+
+    # @rbs (untyped) -> String?
+    def self?.identity: (untyped) -> String?
+  end
+end

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

@@ -16,6 +16,9 @@ module SolidObjects
     # @rbs (MessageReference, timeout: Numeric, ?authorization_context: untyped) -> untyped
     def wait: (MessageReference, timeout: Numeric, ?authorization_context: untyped) -> untyped
 
+    # @rbs (?reference: Reference?, ?request_id: String?, ?idempotency_key: String?, ?authorization_context: untyped) -> MessageReference?
+    def find_by: (?reference: Reference?, ?request_id: String?, ?idempotency_key: String?, ?authorization_context: untyped) -> MessageReference?
+
     # @rbs (Reference, ?authorization_context: untyped) -> StateSnapshot
     def snapshot: (Reference, ?authorization_context: untyped) -> StateSnapshot
 
@@ -29,6 +32,15 @@ module SolidObjects
     # @rbs (reference: Reference, operation: Symbol | String, arguments: Hash[Symbol | String, untyped], idempotency_key: String?, timeout: Numeric) -> MessageReference
     def enqueue_sync: (reference: Reference, operation: Symbol | String, arguments: Hash[Symbol | String, untyped], idempotency_key: String?, timeout: Numeric) -> MessageReference
 
+    # @rbs (Message?, authorization_context: untyped) -> MessageReference?
+    def readable_message: (Message?, authorization_context: untyped) -> MessageReference?
+
+    # @rbs (Message, authorization_context: untyped) -> bool
+    def authorized_to_read?: (Message, authorization_context: untyped) -> bool
+
+    # @rbs (actor_type: String, actor_id: String, operation: String, arguments: Hash[String, untyped], authorization_context: untyped) -> bool
+    def authorized_to_invoke?: (actor_type: String, actor_id: String, operation: String, arguments: Hash[String, untyped], authorization_context: untyped) -> bool
+
     # @rbs (MessageReference, Message) -> void
     def validate_message_reference!: (MessageReference, Message) -> void
 

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

@@ -2,65 +2,71 @@
 
 module SolidObjects
   class Configuration
-    @process_alive_threshold: Float
+    @transmission_actor_type_resolver: Proc
 
-    @shutdown_timeout: Float
+    @broadcast_worker_count: Integer
 
-    @supervisor_monitor_interval: Float
+    @effect_worker_count: Integer
 
-    @retention_interval: Float
+    @worker_count: Integer
 
-    @dead_process_cleanup_interval: Float
+    @redrive_batch_pause: Float
 
-    @message_retention: Numeric
+    @redrive_batch_size: Integer
 
-    @message_retention_by_actor_type: Hash[String, Numeric]
+    @retained_idempotency_keys_bytes: Integer
 
-    @instance_retention_by_actor_type: Hash[String, Numeric]
+    @retained_idempotency_keys: Integer
+
+    @prune_batch_size: Integer
 
     @process_retention: Numeric
 
-    @prune_batch_size: Integer
+    @instance_retention_by_actor_type: Hash[String, Numeric]
 
-    @worker_count: Integer
+    @message_retention_by_actor_type: Hash[String, Numeric]
 
-    @effect_worker_count: Integer
+    @message_retention: Numeric
 
-    @broadcast_worker_count: Integer
+    @dead_process_cleanup_interval: Float
 
-    @reminder_scheduler_count: Integer
+    @retention_interval: Float
 
-    @connects_to: Hash[Symbol, untyped]?
+    @supervisor_monitor_interval: Float
 
-    @logger: untyped
+    @table_name_prefix: String
 
-    @stream_signing_secret: String?
+    @administration_identity: Proc
 
-    @broadcast_adapter: Proc?
+    @authorize_transmission: Proc
 
-    @wake_up_adapter: untyped
+    @authorize_administration: Proc
 
-    @component_path_resolver: Proc?
+    @authorize_subscription: Proc
 
-    @component_authorization_context: Proc
+    @authorize_destroy: Proc
 
-    @payload_authorization_context: Proc
+    @authorize_query: Proc
 
     @authorize_message: Proc
 
-    @authorize_query: Proc
+    @payload_authorization_context: Proc
 
-    @authorize_destroy: Proc
+    @component_authorization_context: Proc
 
-    @authorize_subscription: Proc
+    @component_path_resolver: Proc?
 
-    @authorize_administration: Proc
+    @wake_up_adapter: untyped
 
-    @authorize_transmission: Proc
+    @broadcast_adapter: Proc?
 
-    @transmission_actor_type_resolver: Proc
+    @stream_signing_secret: String?
 
-    @table_name_prefix: String
+    @logger: untyped
+
+    @connects_to: Hash[Symbol, untyped]?
+
+    @reminder_scheduler_count: Integer
 
     @polling_interval: Float
 
@@ -98,6 +104,10 @@ module SolidObjects
 
     @process_heartbeat_interval: Float
 
+    @process_alive_threshold: Float
+
+    @shutdown_timeout: Float
+
     attr_accessor table_name_prefix: untyped
 
     attr_accessor polling_interval: untyped
@@ -156,6 +166,14 @@ module SolidObjects
 
     attr_accessor prune_batch_size: untyped
 
+    attr_accessor retained_idempotency_keys: untyped
+
+    attr_accessor retained_idempotency_keys_bytes: untyped
+
+    attr_accessor redrive_batch_size: untyped
+
+    attr_accessor redrive_batch_pause: untyped
+
     attr_accessor worker_count: untyped
 
     attr_accessor effect_worker_count: untyped
@@ -192,6 +210,8 @@ module SolidObjects
 
     attr_accessor authorize_transmission: untyped
 
+    attr_accessor administration_identity: untyped
+
     attr_accessor transmission_actor_type_resolver: untyped
 
     # @rbs @additional_components: Array[untyped]
@@ -230,6 +250,12 @@ module SolidObjects
 
     private
 
+    # @rbs () -> void
+    def validate_wake_up_adapter!: () -> void
+
+    # @rbs () -> void
+    def validate_wake_up_object!: () -> void
+
     # @rbs () -> Hash[Symbol, Numeric]
     def positive_values: () -> Hash[Symbol, Numeric]
 

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

@@ -30,12 +30,14 @@ module SolidObjects
 
       attr_reader authorization_context(): untyped
 
-      def self.new: (untyped actor, untyped message, untyped authorization_context) -> instance
-                  | (actor: untyped, message: untyped, authorization_context: untyped) -> instance
+      attr_reader instance_id(): untyped
 
-      def self.members: () -> [ :actor, :message, :authorization_context ]
+      def self.new: (untyped actor, untyped message, untyped authorization_context, untyped instance_id) -> instance
+                  | (actor: untyped, message: untyped, authorization_context: untyped, instance_id: untyped) -> instance
 
-      def members: () -> [ :actor, :message, :authorization_context ]
+      def self.members: () -> [ :actor, :message, :authorization_context, :instance_id ]
+
+      def members: () -> [ :actor, :message, :authorization_context, :instance_id ]
     end
 
     # @rbs () -> Frame?
@@ -50,7 +52,10 @@ module SolidObjects
     # @rbs () -> untyped
     def self.authorization_context: () -> untyped
 
-    # @rbs (actor: Actor?, message: MessageContext?, authorization_context: untyped) { () -> untyped } -> untyped
-    def self.with: (actor: Actor?, message: MessageContext?, authorization_context: untyped) { () -> untyped } -> untyped
+    # @rbs () -> Integer?
+    def self.current_instance_id: () -> Integer?
+
+    # @rbs (actor: Actor?, message: MessageContext?, ?authorization_context: untyped, ?instance_id: Integer?) { () -> untyped } -> untyped
+    def self.with: (actor: Actor?, message: MessageContext?, ?authorization_context: untyped, ?instance_id: Integer?) { () -> untyped } -> untyped
   end
 end

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

@@ -8,8 +8,17 @@ module SolidObjects
     # @rbs (Integer, ?authorization_context: untyped) -> MessageReference
     def retry: (Integer, ?authorization_context: untyped) -> MessageReference
 
+    # @rbs () -> DeadLetterScope
+    def effects: () -> DeadLetterScope
+
+    # @rbs () -> DeadLetterScope
+    def broadcasts: () -> DeadLetterScope
+
     private
 
+    # @rbs (DeadLetter) -> MessageReference
+    def enqueue_retry: (DeadLetter) -> MessageReference
+
     # @rbs (Symbol, authorization_context: untyped, ?dead_letter_id: Integer?) -> void
     def authorize!: (Symbol, authorization_context: untyped, ?dead_letter_id: Integer?) -> void
   end

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

@@ -0,0 +1,58 @@
+# Generated from lib/solid_objects/dead_letter_scope.rb with RBS::Inline
+
+module SolidObjects
+  class DeadLetterScope
+    DEAD: ::String
+
+    PENDING: ::String
+
+    @identifier: Symbol
+
+    @resource: String
+
+    @model: untyped
+
+    attr_reader resource: untyped
+
+    attr_reader kind: untyped
+
+    # @rbs (model: untyped, resource: String, identifier: Symbol, kind: String) -> void
+    def initialize: (model: untyped, resource: String, identifier: Symbol, kind: String) -> void
+
+    # @rbs (String) -> DeadLetterScope
+    def self.for_kind: (String) -> DeadLetterScope
+
+    # @rbs (?authorization_context: untyped) -> Array[DeadRow]
+    def all: (?authorization_context: untyped) -> Array[DeadRow]
+
+    # @rbs (String, ?authorization_context: untyped) -> untyped
+    def retry: (String, ?authorization_context: untyped) -> untyped
+
+    # @rbs (?actor_type: String?, ?failed_after: untyped, ?limit: Integer?, ?authorization_context: untyped) -> RedriveTask
+    def redrive: (?actor_type: String?, ?failed_after: untyped, ?limit: Integer?, ?authorization_context: untyped) -> RedriveTask
+
+    # @rbs () -> ActiveRecord::Relation[untyped]
+    def dead: () -> ActiveRecord::Relation[untyped]
+
+    # @rbs (Hash[String, untyped], ?dead_before: untyped) -> ActiveRecord::Relation[untyped]
+    def matching: (Hash[String, untyped], ?dead_before: untyped) -> ActiveRecord::Relation[untyped]
+
+    # @rbs (Array[untyped]) -> Integer
+    def revive_all: (Array[untyped]) -> Integer
+
+    # @rbs (untyped) -> Integer
+    def revive: (untyped) -> Integer
+
+    # @rbs (Symbol, authorization_context: untyped, ?resource_id: String?) -> void
+    def authorize!: (Symbol, authorization_context: untyped, ?resource_id: String?) -> void
+
+    private
+
+    attr_reader model: untyped
+
+    attr_reader identifier: untyped
+
+    # @rbs () -> Hash[Symbol, untyped]
+    def revival_attributes: () -> Hash[Symbol, untyped]
+  end
+end

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

@@ -0,0 +1,30 @@
+# Generated from lib/solid_objects/dead_row.rb with RBS::Inline
+
+module SolidObjects
+  class DeadRow < Data
+    attr_reader id(): untyped
+
+    attr_reader kind(): untyped
+
+    attr_reader actor_type(): untyped
+
+    attr_reader actor_id(): untyped
+
+    attr_reader status(): untyped
+
+    attr_reader attempt_count(): untyped
+
+    attr_reader available_at(): untyped
+
+    attr_reader failed_at(): untyped
+
+    attr_reader error(): untyped
+
+    def self.new: (untyped id, untyped kind, untyped actor_type, untyped actor_id, untyped status, untyped attempt_count, untyped available_at, untyped failed_at, untyped error) -> instance
+                | (id: untyped, kind: untyped, actor_type: untyped, actor_id: untyped, status: untyped, attempt_count: untyped, available_at: untyped, failed_at: untyped, error: untyped) -> instance
+
+    def self.members: () -> [ :id, :kind, :actor_type, :actor_id, :status, :attempt_count, :available_at, :failed_at, :error ]
+
+    def members: () -> [ :id, :kind, :actor_type, :actor_id, :status, :attempt_count, :available_at, :failed_at, :error ]
+  end
+end

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

@@ -75,6 +75,9 @@ module SolidObjects
     # @rbs () -> Check
     def check_database_server: () -> Check
 
+    # @rbs () -> Check
+    def check_wake_up: () -> Check
+
     # @rbs () -> Check
     def check_runtime: () -> Check
 

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

@@ -232,4 +232,12 @@ module SolidObjects
 
   class ActorCallCycle < Error
   end
+
+  class MessagePruned < Error
+    # @rbs @idempotency_key: String
+    attr_reader idempotency_key: untyped
+
+    # @rbs (String) -> void
+    def initialize: (String) -> void
+  end
 end

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

@@ -65,6 +65,12 @@ module SolidObjects
     # @rbs (Instance, Array[Actor::ReminderIntent]) -> Array[Hash[Symbol, untyped]]
     def schedule_reminders: (Instance, Array[Actor::ReminderIntent]) -> Array[Hash[Symbol, untyped]]
 
+    # A cancel reports nothing, because a reminder that no longer exists did not
+    # move. Deleting the row rather than marking it keeps a later schedule of the
+    # same name free of a tombstone.
+    # @rbs (Instance, Actor::UnscheduleIntent | Actor::UnscheduleAllIntent) -> nil
+    def cancel_reminder: (Instance, Actor::UnscheduleIntent | Actor::UnscheduleAllIntent) -> nil
+
     # Arguments are omitted deliberately: a reminder carries application data
     # and this event exists to be logged.
     # @rbs (Reminder, Time?) -> Hash[Symbol, untyped]?
@@ -88,6 +94,9 @@ module SolidObjects
     # @rbs () -> ClaimedMessage
     def matching_claim!: () -> ClaimedMessage
 
+    # @rbs (Instance, Message) -> Array[Hash[String, untyped]]
+    def remembered_keys: (Instance, Message) -> Array[Hash[String, untyped]]
+
     # @rbs (Exception) -> Hash[String, untyped]
     def serialized_error: (Exception) -> Hash[String, untyped]
 

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

@@ -34,7 +34,15 @@ module SolidObjects
     # @rbs () -> untyped
     def result: () -> untyped
 
+    # @rbs () -> Outcome
+    def outcome: () -> Outcome
+
     # @rbs (?timeout: Numeric, ?authorization_context: untyped) -> untyped
     def wait: (?timeout: Numeric, ?authorization_context: untyped) -> untyped
+
+    private
+
+    # @rbs (Message) -> String
+    def status_of: (Message) -> String
   end
 end