chromium/chrome/browser/ash/crostini/crostini_upgrader_ui_delegate.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_CROSTINI_CROSTINI_UPGRADER_UI_DELEGATE_H_
#define CHROME_BROWSER_ASH_CROSTINI_CROSTINI_UPGRADER_UI_DELEGATE_H_

#include <string>

#include "base/memory/weak_ptr.h"
#include "chrome/browser/ui/webui/ash/crostini_upgrader/crostini_upgrader.mojom-forward.h"

namespace base {
class FilePath;
}  // namespace base

namespace content {
class WebContents;
}  // namespace content

namespace guest_os {
struct GuestId;
}

namespace crostini {

class CrostiniUpgraderUIObserver {
 public:
  virtual void OnBackupMaybeStarted(bool did_start) {}
  virtual void OnBackupProgress(int percent) = 0;
  virtual void OnBackupSucceeded(bool was_cancelled) = 0;
  virtual void OnBackupFailed() = 0;
  virtual void PrecheckStatus(
      ash::crostini_upgrader::mojom::UpgradePrecheckStatus status) = 0;
  virtual void OnUpgradeProgress(const std::vector<std::string>& messages) = 0;
  virtual void OnUpgradeSucceeded() = 0;
  virtual void OnUpgradeFailed() = 0;
  virtual void OnRestoreProgress(int percent) = 0;
  virtual void OnRestoreSucceeded() = 0;
  virtual void OnRestoreFailed() = 0;
  virtual void OnCanceled() = 0;
  virtual void OnLogFileCreated(const base::FilePath& path) {}
};

class CrostiniUpgraderUIDelegate {
 public:
  // |observer| is  used to relay progress messages as they are received from
  // the upgrade flow.
  virtual void AddObserver(CrostiniUpgraderUIObserver* observer) = 0;
  virtual void RemoveObserver(CrostiniUpgraderUIObserver* observer) = 0;

  // Signal to the delegate that a new dialogue instance has been opened. The
  // dialogue currently automatically re-tries the upgrade up to three
  // times. This method allows the delegate to distinguish between these retries
  // and upgrades from separate sessions.
  virtual void PageOpened() = 0;

  // Back up the current container before upgrading. If |show_file_chooser|
  // is true, the user will be able to select the backup location via a file
  // chooser.
  virtual void Backup(const guest_os::GuestId& container_id,
                      bool show_file_chooser,
                      base::WeakPtr<content::WebContents> web_contents) = 0;

  virtual void StartPrechecks() = 0;

  // Start the upgrade.
  virtual void Upgrade(const guest_os::GuestId& container_id) = 0;

  // Restore the container to the backed up state if an upgrade has failed.
  virtual void Restore(const guest_os::GuestId& container_id,
                       base::WeakPtr<content::WebContents> web_contents) = 0;

  // Cancel the ongoing upgrade.
  virtual void Cancel() = 0;

  // UI should call this if the user cancels without starting upgrade so
  // metrics can be recorded.
  virtual void CancelBeforeStart() = 0;
};

}  // namespace crostini

#endif  // CHROME_BROWSER_ASH_CROSTINI_CROSTINI_UPGRADER_UI_DELEGATE_H_