components/unexportable_keys/background_task_priority.h

// Copyright 2023 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef COMPONENTS_UNEXPORTABLE_KEYS_BACKGROUND_TASK_PRIORITY_H_
#define COMPONENTS_UNEXPORTABLE_KEYS_BACKGROUND_TASK_PRIORITY_H_

#include <cstddef>
#include <string_view>

#include "base/component_export.h"

namespace unexportable_keys {

// Ordered list of priorities supported by the unexportable key task manager.
// The priorities are ordered from the lowest one to the highest one.
// LINT.IfChange
enum class BackgroundTaskPriority {
  // For speculative work that must never delay any other task, such as
  // refilling the spare key pool. This is the lowest priority that yields to
  // everything else.
  kMinPriorityInternalUseOnly = 0,

  // For non-urgent work, that will only execute if there's nothing else to do.
  kBestEffort = 1,

  // The result of these tasks are visible to the user (in the UI or as a
  // side-effect on the system) but they are not an immediate response to a user
  // interaction.
  kUserVisible = 2,

  // Tasks that affect the UI immediately after a user interaction.
  kUserBlocking = 3,

  kMaxValue = kUserBlocking
};
// LINT.ThenChange(/components/unexportable_keys/mojom/unexportable_key_service.mojom)

constexpr size_t kNumTaskPriorities =
    static_cast<size_t>(BackgroundTaskPriority::kMaxValue) + 1;

// Converts `BackgroundTaskPriority` to a histogram suffix string. The string is
// prepended with "." symbol so it can be directly concatenated with a base
// histogram name.
COMPONENT_EXPORT(UNEXPORTABLE_KEYS)
std::string_view GetBackgroundTaskPrioritySuffixForHistograms(
    BackgroundTaskPriority priority);

}  // namespace unexportable_keys

#endif  // COMPONENTS_UNEXPORTABLE_KEYS_BACKGROUND_TASK_PRIORITY_H_