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

#ifndef CHROME_BROWSER_EXTENSIONS_EXTENSION_URL_OVERRIDES_H_
#define CHROME_BROWSER_EXTENSIONS_EXTENSION_URL_OVERRIDES_H_

#include "components/favicon_base/favicon_callback.h"
#include "content/public/browser/web_ui_controller.h"
#include "extensions/buildflags/buildflags.h"
#include "extensions/common/manifest_handlers/chrome_url_overrides_handler.h"

static_assert(BUILDFLAG(ENABLE_EXTENSIONS_CORE));

class Profile;

namespace content {
class BrowserContext;
}

namespace extensions {
class Extension;
}

namespace user_prefs {
class PrefRegistrySyncable;
}

// A collection of methods to handle Chrome URL overrides that are managed by
// extensions (such as overriding the new tab page).
class ExtensionUrlOverrides {
 public:
  static const char kExtensionURLOverrides[];

  static bool HandleChromeURLOverride(GURL* url,
                                      content::BrowserContext* browser_context);
  static bool HandleChromeURLOverrideReverse(
      GURL* url,
      content::BrowserContext* browser_context);

  // Returns the extension that currently controls the specified `url`, if any.
  static const extensions::Extension* GetExtensionControllingURL(
      const GURL& url,
      content::BrowserContext* browser_context);

  // Returns the number of extensions that are overriding the given `url`. Note
  // that only one is *actively* overriding it; the others would take over if
  // that one were to be disabled or removed.
  static size_t GetNumberOfExtensionsOverridingURL(
      const GURL& url,
      content::BrowserContext* browser_context);

  // Initialize the Chrome URL overrides. This must happen *before* any further
  // calls for URL overrides!
  static void InitializeChromeURLOverrides(Profile* profile);

  // Validate the Chrome URL overrides, ensuring that each is valid and points
  // to an existing extension. To be called once all extensions are loaded.
  static void ValidateChromeURLOverrides(Profile* profile);

  // Add new Chrome URL overrides. If an entry exists, it is marked as active.
  // If one doesn't exist, it is added at the beginning of the list of
  // overrides (meaning it has priority).
  static void RegisterOrActivateChromeURLOverrides(
      Profile* profile,
      const extensions::URLOverrides::URLOverrideMap& overrides);

  // Deactivate overrides without removing them from the list or modifying their
  // positions in the list.
  static void DeactivateChromeURLOverrides(
      Profile* profile,
      const extensions::URLOverrides::URLOverrideMap& overrides);

  // Completely unregister overrides, removing them from the list.
  static void UnregisterChromeURLOverrides(
      Profile* profile,
      const extensions::URLOverrides::URLOverrideMap& overrides);

  // Called from BrowserPrefs
  static void RegisterProfilePrefs(user_prefs::PrefRegistrySyncable* registry);

  // Get the favicon for the extension by getting an icon from the manifest.
  // Note. `callback` is always run asynchronously.
  static void GetFaviconForURL(Profile* profile,
                               const GURL& page_url,
                               favicon_base::FaviconResultsCallback callback);
};

#endif  // CHROME_BROWSER_EXTENSIONS_EXTENSION_URL_OVERRIDES_H_