@type error_category() :: :retryable | :terminal | :fatal

@type error_response() :: %{
  type: :outbound_error,
  category: error_category(),
  disposition: :retry | :terminal,
  operation: operation(),
  reason: term(),
  attempt: pos_integer(),
  max_attempts: pos_integer(),
  partition: non_neg_integer(),
  routing_key: String.t(),
  retryable: boolean()
}

@type operation() :: :send | :edit | :send_media | :edit_media

@type priority() :: :critical | :high | :normal | :low

@type request() :: %{
  :operation => operation(),
  :channel => module(),
  :bridge_id => String.t(),
  :external_room_id => term(),
  :payload => String.t() | map(),
  :opts => keyword(),
  :routing_key => String.t(),
  :session_key => Jido.Messaging.SessionManager.session_key(),
  optional(:external_message_id) => term(),
  optional(:route_resolution) => Jido.Messaging.SessionManager.resolution(),
  optional(:idempotency_key) => String.t() | nil,
  optional(:max_attempts) => pos_integer() | nil,
  optional(:base_backoff_ms) => pos_integer() | nil,
  optional(:max_backoff_ms) => pos_integer() | nil,
  optional(:priority) => priority()
}

@type success_response() :: %{
  :operation => operation(),
  :message_id => term(),
  :result => map(),
  :partition => non_neg_integer(),
  :attempts => pos_integer(),
  :routing_key => String.t(),
  :pressure_level => :normal | :warn | :degraded | :shed,
  :idempotent => boolean(),
  optional(:route_resolution) => Jido.Messaging.SessionManager.resolution(),
  optional(:security) => map(),
  optional(:media) => map()
}