chrome/browser/ash/child_accounts/child_user_service.h

// Copyright 2019 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_ASH_CHILD_ACCOUNTS_CHILD_USER_SERVICE_H_
#define CHROME_BROWSER_ASH_CHILD_ACCOUNTS_CHILD_USER_SERVICE_H_

#include <memory>
#include <set>
#include <string>

#include "base/memory/raw_ptr.h"
#include "chrome/browser/ash/child_accounts/time_limits/app_activity_report_interface.h"
#include "chrome/browser/ash/child_accounts/time_limits/app_time_limit_interface.h"
#include "chrome/browser/ash/child_accounts/website_approval_notifier.h"
#include "components/keyed_service/core/keyed_service.h"
#include "components/prefs/pref_change_registrar.h"
#include "components/services/app_service/public/cpp/app_types.h"

namespace base {
class TimeDelta;
}  // namespace base

namespace content {
class BrowserContext;
}  // namespace content

namespace enterprise_management {
class ChildStatusReportRequest;
}  // namespace enterprise_management

class Profile;

namespace ash {
namespace app_time {
class AppId;
class AppTimeController;
}  // namespace app_time

// Facade that exposes child user related functionality on Chrome OS.
// TODO(crbug.com/40106527): Migrate ConsumerStatusReportingService,
// EventBasedStatusReporting and ScreenTimeController to ChildUserService.
class ChildUserService : public KeyedService,
                         public app_time::AppTimeLimitInterface,
                         public app_time::AppActivityReportInterface {
 public:
  // Used for tests to get internal implementation details.
  class TestApi {
   public:
    explicit TestApi(ChildUserService* service);
    ~TestApi();

    app_time::AppTimeController* app_time_controller();

   private:
    const raw_ptr<ChildUserService> service_;
  };

  // These enum values represent the current Family Link user's time limit
  // policy type for the Family Experiences team's metrics. Multiple time
  // limit policy types might be enabled at the same time. These values are
  // logged to UMA. Entries should not be renumbered and numeric values should
  // never be reused. Please keep in sync with "TimeLimitPolicyType" in
  // src/tools/metrics/histograms/enums.xml.
  enum class TimeLimitPolicyType {
    kNoTimeLimit = 0,
    kOverrideTimeLimit = 1,
    kBedTimeLimit = 2,
    kScreenTimeLimit = 3,
    // TODO(crbug.com/40771730) deprecate this enum
    kWebTimeLimit = 4,
    kAppTimeLimit = 5,  // Does not cover blocked apps.

    // Used for UMA. Update kMaxValue to the last value. Add future entries
    // above this comment. Sync with enums.xml.
    kMaxValue = kAppTimeLimit
  };

  static const char* GetTimeLimitPolicyTypesHistogramNameForTest();

  explicit ChildUserService(content::BrowserContext* context);
  ChildUserService(const ChildUserService&) = delete;
  ChildUserService& operator=(const ChildUserService&) = delete;
  ~ChildUserService() override;

  // app_time::AppTimeLimitInterface:
  void PauseWebActivity(const std::string& app_service_id) override;
  void ResumeWebActivity(const std::string& app_service_id) override;
  std::optional<base::TimeDelta> GetTimeLimitForApp(
      const std::string& app_service_id,
      apps::AppType app_type) override;

  // app_time::AppActivityReportInterface:
  app_time::AppActivityReportInterface::ReportParams GenerateAppActivityReport(
      enterprise_management::ChildStatusReportRequest* report) override;
  void AppActivityReportSubmitted(
      base::Time report_generation_timestamp) override;

  // Returns whether the application with id |app_id| can be used without any
  // time restrictions.
  bool AppTimeLimitAllowlistedApp(const app_time::AppId& app_id) const;

  // Report enabled TimeLimitPolicyType.
  void ReportTimeLimitPolicy() const;

 private:
  // KeyedService:
  void Shutdown() override;

  const raw_ptr<Profile> profile_;

  std::unique_ptr<app_time::AppTimeController> app_time_controller_;

  // Preference changes observer.
  PrefChangeRegistrar pref_change_registrar_;

  // Used to display notifications when new websites are approved.
  WebsiteApprovalNotifier website_approval_notifier_;
};

}  // namespace ash

#endif  // CHROME_BROWSER_ASH_CHILD_ACCOUNTS_CHILD_USER_SERVICE_H_