ash/webui/shimless_rma/resources/shimless_3p_diagnostics.ts

// 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.

import './shimless_rma_shared.css.js';
import 'chrome://resources/ash/common/cr_elements/cr_button/cr_button.js';
import 'chrome://resources/ash/common/cr_elements/cr_dialog/cr_dialog.js';

import {loadTimeData} from 'chrome://resources/ash/common/load_time_data.m.js';
import {CrDialogElement} from 'chrome://resources/ash/common/cr_elements/cr_dialog/cr_dialog.js';
import {I18nMixin} from 'chrome://resources/ash/common/cr_elements/i18n_mixin.js';
import {assert, assertNotReached} from 'chrome://resources/js/assert.js';
import {FilePath} from 'chrome://resources/mojo/mojo/public/mojom/base/file_path.mojom-webui.js';
import {PolymerElement} from 'chrome://resources/polymer/v3_0/polymer/polymer_bundled.min.js';

import {getShimlessRmaService} from './mojo_interface_provider.js';
import {getTemplate} from './shimless_3p_diagnostics.html.js';
import {Shimless3pDiagnosticsAppInfo, ShimlessRmaServiceInterface, Show3pDiagnosticsAppResult} from './shimless_rma.mojom-webui.js';
import {disableAllButtons, enableAllButtons} from './shimless_rma_util.js';

/**
 * @fileoverview
 * 'shimless-3p-diagnostics' manages dialogs to install and show 3p diagnostics
 * app.
 */

const Shimless3pDiagnosticsBase = I18nMixin(PolymerElement);

export class Shimless3pDiagnostics extends Shimless3pDiagnosticsBase {
  static get is() {
    return 'shimless-3p-diagnostics' as const;
  }

  static get template() {
    return getTemplate();
  }

  static get properties() {
    return {
      hasPendingLaunch: {
        type: Boolean,
        value: false,
      },

      providerName: {
        type: String,
        value: '',
      },

      installableAppPath: {
        type: String,
        value: '',
      },

      appInfo: {
        type: Object,
        value: null,
      },

      errorTitle: {
        type: String,
        value: '',
      },

      errorMessage: {
        type: String,
        value: '',
      },
    };
  }

  private hasPendingLaunch: boolean;
  protected providerName: string|null;
  protected installableAppPath: string;
  protected appInfo: Shimless3pDiagnosticsAppInfo|null;
  protected errorTitle: string;
  protected errorMessage: string;
  private shimlessRmaService: ShimlessRmaServiceInterface =
      getShimlessRmaService();

  constructor() {
    super();

    if (!loadTimeData.getBoolean('3pDiagnosticsEnabled')) {
      return;
    }

    this.shimlessRmaService.get3pDiagnosticsProvider().then(
        ({provider}: {provider: string|null}) => {
          this.providerName = provider;
        });
  }

  /**
   * Ends the launch process and enables all buttons.
   */
  private completeLaunch(): void {
    this.hasPendingLaunch = false;
    enableAllButtons(this);
  }

  /**
   * Shows the error dialog with specific title and message.
   */
  private showError(titleId: string, messageId: string): void {
    assert(this.providerName);
    this.errorTitle = this.i18n(titleId, this.providerName);
    this.errorMessage = this.i18n(messageId);
    const dialog: CrDialogElement|null =
        this.shadowRoot!.querySelector('#shimless3pDiagErrorDialog');
    assert(dialog);
    dialog.showModal();
  }

  /**
   * Shows the dialog to ask whether users want to install an installable app
   * from external storage or not.
   */
  private showFindInstallableDialog(appPath: FilePath): void {
    this.installableAppPath = appPath.path;
    const dialog: CrDialogElement|null =
        this.shadowRoot!.querySelector('#shimless3pDiagFindInstallableDialog');
    assert(dialog);
    dialog.showModal();
  }

  /**
   * Completes the last installation by replying the user approval result. If
   * the installation is approved, then show the app. Otherwise, just finish the
   * launch process.
   */
  private completeLastInstall(isApproved: boolean): void {
    this.shimlessRmaService.completeLast3pDiagnosticsInstallation(isApproved)
        .then(() => {
          isApproved ? this.show3pDiagnosticsApp() : this.completeLaunch();
        });
  }

  /**
   * Shows the permission review dialog for users to review the app permissions.
   * If there is no permission requested, the dialog won't be shown and the app
   * is approved.
   */
  private showPermissionReviewDialogOrCompleteLastInstall(
      appInfo: Shimless3pDiagnosticsAppInfo): void {
    if (!appInfo.permissionMessage) {
      this.completeLastInstall(true);
      return;
    }

    this.appInfo = appInfo;
    const dialog: CrDialogElement|null =
        this.shadowRoot!.querySelector('#shimless3pDiagReviewPermissionDialog');
    assert(dialog);
    dialog.showModal();
  }

  /**
   * Shows the 3p diagnostics app. The app dialog will be shown in another
   * webview outside of this webui. If no app is installed or fails to load
   * installed app, shows the error.
   */
  private show3pDiagnosticsApp(): void {
    this.shimlessRmaService.show3pDiagnosticsApp().then(
        (result: {result: Show3pDiagnosticsAppResult}) => {
          switch (result.result) {
            case Show3pDiagnosticsAppResult.kOk:
              this.completeLaunch();
              return;
            case Show3pDiagnosticsAppResult.kAppNotInstalled:
              this.showError(
                  '3pNotInstalledDialogTitle', '3pCheckWithOemDialogMessage');
              return;
            case Show3pDiagnosticsAppResult.kFailedToLoad:
              this.showError(
                  '3pFailedToLoadDialogTitle', '3pFailedToLoadDialogMessage');
              return;
          }
          assertNotReached();
        });
  }

  /**
   * Handles cancel event or skip button of installable dialog. Skips the
   * install process and tries to load the installed app.
   */
  protected onCancelOrSkipInstallButtonClicked(): void {
    const dialog: CrDialogElement|null =
        this.shadowRoot!.querySelector('#shimless3pDiagFindInstallableDialog');
    assert(dialog);
    dialog.close();
    this.show3pDiagnosticsApp();
  }

  /**
   * Handles install button of installable dialog. Installs the installable app.
   */
  protected onInstallButtonClicked(): void {
    const dialog: CrDialogElement|null =
        this.shadowRoot!.querySelector('#shimless3pDiagFindInstallableDialog');
    assert(dialog);
    dialog.close();
    this.shimlessRmaService.installLastFound3pDiagnosticsApp().then(
        (result: {appInfo: Shimless3pDiagnosticsAppInfo|null}) => {
          result.appInfo ? this.showPermissionReviewDialogOrCompleteLastInstall(
                               result.appInfo) :
                           this.showError(
                               '3pFailedToInstallDialogTitle',
                               '3pCheckWithOemDialogMessage');
        });
  }

  /**
   * Handles cancel event or cancel button of permission review dialog. Cancels
   * the installation and ends the launch process.
   */
  protected onCancelOrCancelInstallButtonClicked(): void {
    const dialog: CrDialogElement|null =
        this.shadowRoot!.querySelector('#shimless3pDiagReviewPermissionDialog');
    assert(dialog);
    dialog.close();
    this.completeLastInstall(/*isApproved=*/ false);
  }

  /**
   * Handles accept button of permission review dialog. Continues the
   * installation.
   */
  protected onAcceptPermissionButtonClicked(): void {
    const dialog: CrDialogElement|null =
        this.shadowRoot!.querySelector('#shimless3pDiagReviewPermissionDialog');
    assert(dialog);
    dialog.close();
    this.completeLastInstall(/*isApproved=*/ true);
  }

  /**
   * Handles cancel event or back button of error dialog. Close the dialog and
   * ends the launch process.
   */
  protected onErrorDialogCancelOrBackButtonClicked(): void {
    const dialog: CrDialogElement|null =
        this.shadowRoot!.querySelector('#shimless3pDiagErrorDialog');
    assert(dialog);
    dialog.close();
    this.completeLaunch();
  }

  /**
   * Launch the 3p diagnostics app. This will ask if users want to install the
   * app from external storage if app files exist, or launch the installed app.
   */
  launch3pDiagnostics(): void {
    if (!loadTimeData.getBoolean('3pDiagnosticsEnabled') ||
        this.hasPendingLaunch) {
      return;
    }

    // If there is no provider or provider is not yet fetched, don't show
    // any UI action and just return.
    if (!this.providerName) {
      return;
    }

    this.hasPendingLaunch = true;
    disableAllButtons(this, /*showBusyStateOverlay=*/ true);

    this.shimlessRmaService.getInstallable3pDiagnosticsAppPath().then(
        (result: {appPath: FilePath|null}) => {
          result.appPath ? this.showFindInstallableDialog(result.appPath) :
                           this.show3pDiagnosticsApp();
        });
  }
}

declare global {
  interface HTMLElementTagNameMap {
    [Shimless3pDiagnostics.is]: Shimless3pDiagnostics;
  }
}

customElements.define(Shimless3pDiagnostics.is, Shimless3pDiagnostics);