// Copyright 2025 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_BROWSER_APIS_TAB_STRIP_UTILITIES_TAB_STRIP_API_UTILITIES_H_
#define COMPONENTS_BROWSER_APIS_TAB_STRIP_UTILITIES_TAB_STRIP_API_UTILITIES_H_

#include <optional>
#include <string>
#include <string_view>
#include <vector>

#include "base/types/expected.h"
#include "components/browser_apis/tab_strip/tab_strip_api_types.mojom.h"
#include "components/browser_apis/tab_strip/types/node_id.h"
#include "components/tab_groups/tab_group_id.h"
#include "components/tab_groups/tab_group_visual_data.h"
#include "mojo/public/mojom/base/error.mojom.h"

namespace tabs_api {
class TabStripModelAdapter;

// Field names for Update masks.
inline constexpr std::string_view kTitleField = "title";
inline constexpr std::string_view kColorField = "color";
inline constexpr std::string_view kIsCollapsedField = "is_collapsed";
inline constexpr std::string_view kUrlField = "url";

}  // namespace tabs_api

// Helper functions for clients of the TabStripService API.
namespace tabs_api::utils {

// Returns the NodeId from any variant of the mojom::Data union.
const tabs_api::NodeId& GetNodeId(const mojom::Data& data);

// Returns the tab group id for a given node id.
base::expected<tab_groups::TabGroupId, mojo_base::mojom::ErrorPtr>
GetTabGroupId(TabStripModelAdapter& adapter, const NodeId& node_id);

// Merges the fields from incoming into current based on the update mask.
base::expected<tab_groups::TabGroupVisualData, mojo_base::mojom::ErrorPtr>
MergeTabGroupVisualData(const tab_groups::TabGroupVisualData& current,
                        const tab_groups::TabGroupVisualData& incoming,
                        const std::optional<std::vector<std::string>>& mask);

}  // namespace tabs_api::utils

#endif  // COMPONENTS_BROWSER_APIS_TAB_STRIP_UTILITIES_TAB_STRIP_API_UTILITIES_H_