// 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_ENTERPRISE_CONNECTORS_CORE_CONTENT_AREA_USER_PROVIDER_H_
#define COMPONENTS_ENTERPRISE_CONNECTORS_CORE_CONTENT_AREA_USER_PROVIDER_H_

#include "url/gurl.h"

namespace signin {
class IdentityManager;
}  // namespace signin

namespace enterprise_connectors {

// Returns email of the active Gaia user based on the values provided by
// tab url and identity manager. Only returns a value for google.com sites.
std::string GetActiveContentAreaUser(signin::IdentityManager* im,
                                     const GURL& tab_url);

// Returns email of the active Gaia user based on the values found in the
// provided frame URL and identity manager. Only returns a value if `tab_url` is
// a Workspace site.
std::string GetActiveFrameUser(signin::IdentityManager* im,
                               const GURL& tab_url,
                               const GURL& frame_url);

// Returns a default value for an active Gaia user based on the provided URL and
// identity manager. This should be called after either
// `GetActiveContentAreaUser` or `GetActiveFrameUser` have been used to attempt
// to retrieve an active user.
std::string GetDefaultActiveUser(signin::IdentityManager* im, const GURL& url);

// Returns email of the active Gaia user checks performed at navigation time.
// Only returns a value for google.com sites.
std::string GetNavigationActiveContentAreaUser(signin::IdentityManager* im,
                                               const GURL& tab_url);

// Returns true if the main tab should be able to have its active user
// retrieved. If this returns false, none of the other functions in this file
// should be called.
bool CanRetrieveActiveUser(const GURL& tab_url);

}  // namespace enterprise_connectors

#endif  // COMPONENTS_ENTERPRISE_CONNECTORS_CORE_CONTENT_AREA_USER_PROVIDER_H_