@type reason() ::
  :compatibility_mismatch
  | :undeclared_capability
  | :unavailable_capability
  | :commerce_corridor
  | :origin_denied
  | :inactive_route
  | :external_entry_denied
  | :pack_incompatible
  | :gate_denied
  | :kill_switch_active
  | :step_up_required
  | :notification_open_denied

@type t() :: %Crosswake.Shell.Denial{
  code: String.t(),
  details: map(),
  hint: String.t() | nil,
  message: String.t(),
  reason: reason(),
  recovery: map(),
  route_id: String.t() | nil
}