chrome/browser/tpcd/experiment/experiment_manager.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 CHROME_BROWSER_TPCD_EXPERIMENT_EXPERIMENT_MANAGER_H_
#define CHROME_BROWSER_TPCD_EXPERIMENT_EXPERIMENT_MANAGER_H_

#include "base/no_destructor.h"
#include "third_party/abseil-cpp/absl/types/optional.h"

namespace tpcd::experiment {

class ExperimentManager {
 public:
  static ExperimentManager* GetInstance();

  // Called by EligibilityService to tell the manager whether a profile is
  // eligible. Mode B also needs to know whether the profile has been onboarded
  // to the 3PCD UX, but Mode A does not.
  void SetClientEligibility(bool is_eligible, bool is_onboarded = false);

  // Returns the final decision for client eligiblity, if completed.
  // absl::nullopt will be returned if the final decision has not been made yet.
  absl::optional<bool> IsClientEligible() const;

 protected:
  ExperimentManager();
  ~ExperimentManager() = default;

 private:
  friend base::NoDestructor<ExperimentManager>;

  // Mode B experiment will need to register the client for the synthetic trial
  // IFF the client is eligible and onboarded (TCPDExperimentState ==
  // kOnboardedEligible). Register the client for the correct arm of the
  // synthetic trial based on Finch feature params.
  void RegisterSyntheticTrial();

  // If a previously registered client becomes ineligible, unregister it from
  // the synthetic trial by registering it to a "invalidated" experiment arm.
  void UnregisterSyntheticTrial();

  // Check the client is eligible for 3PCD Experiments. Returns false when: the
  // client is <30 days old or Android users with a PWA installed.
  bool isClientEligible();
};

}  // namespace tpcd::experiment

#endif  // CHROME_BROWSER_TPCD_EXPERIMENT_EXPERIMENT_MANAGER_H_