// 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_PREINSTALLED_EXTENSIONS_H_
#define CHROME_BROWSER_EXTENSIONS_PREINSTALLED_EXTENSIONS_H_

#include "base/memory/raw_ptr.h"
#include "base/memory/scoped_refptr.h"
#include "base/values.h"
#include "chrome/browser/extensions/external_provider_impl.h"
#include "extensions/buildflags/buildflags.h"
#include "extensions/common/manifest.h"
#include "extensions/common/mojom/manifest.mojom-shared.h"

static_assert(BUILDFLAG(ENABLE_EXTENSIONS_CORE));

class Profile;

namespace user_prefs {
class PrefRegistrySyncable;
}

// Functions and types related to preinstalling extensions.
namespace preinstalled_extensions {

// These enum values are persisted in the user preferences, so they should not
// be changed.
enum InstallState {
  kUnknown,
  // Now unused, left for backward compatibility.
  kProvideLegacyPreinstalledApps,
  kNeverInstallPreinstalledExtensions,
  kAlreadyInstalledPreinstalledExtensions
};

// Register preference properties used by default apps to maintain
// install state.
void RegisterProfilePrefs(user_prefs::PrefRegistrySyncable* registry);

// A specialization of the ExternalProviderImpl that conditionally installs
// extensions based on a hard-coded list.
class Provider : public extensions::ExternalProviderImpl {
 public:
  Provider(Profile* profile,
           VisitorInterface* service,
           extensions::mojom::ManifestLocation crx_location,
           extensions::mojom::ManifestLocation download_location,
           int creation_flags);

  Provider(const Provider&) = delete;
  Provider& operator=(const Provider&) = delete;

  // ExternalProviderImpl overrides:
  void VisitRegisteredExtension() override;
  void SetPrefs(base::DictValue prefs) override;

  static bool DidPerformNewInstallationForProfile(Profile* profile);

  // Exposed for testing.
  bool preinstalled_extensions_enabled() const {
    return preinstalled_extensions_enabled_;
  }
  bool is_migration() const { return is_migration_; }
  bool perform_new_installation() const { return perform_new_installation_; }

 private:
  // Initializes state for the Provider based on the profile.
  void InitProfileState();

  // Adds an extension to the provided `prefs`.
  void AddExtension(const std::string& extension_id, base::DictValue& prefs);

  // The associated profile.
  raw_ptr<Profile> profile_ = nullptr;
  // Whether default extensions are enabled for the profile.
  bool preinstalled_extensions_enabled_ = false;
  // Whether this is the first run since a migration from Chrome 22-ish.
  bool is_migration_ = false;
  // Whether this class should perform a new installation, such as for a
  // new profile.
  bool perform_new_installation_ = false;
};

}  // namespace preinstalled_extensions

#endif  // CHROME_BROWSER_EXTENSIONS_PREINSTALLED_EXTENSIONS_H_