chrome/browser/resources/settings/chromeos/os_people_page/os_sync_browser_proxy.js

// Copyright 2019 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

cr.define('settings', function() {
  /**
   * User preferences for OS sync. 'Registered' means the user has the option to
   * select a type. For example, a type might not be registered due to a feature
   * flag being disabled.
   * @see components/sync/driver/sync_service.h
   *
   * TODO(jamescook): Encryption options.
   *
   * @typedef {{
   *   osAppsRegistered: boolean,
   *   osAppsSynced: boolean,
   *   osPreferencesRegistered: boolean,
   *   osPreferencesSynced: boolean,
   *   syncAllOsDataTypes: boolean,
   *   wallpaperEnabled: boolean,
   *   osWifiConfigurationsRegistered: boolean,
   *   osWifiConfigurationsSynced: boolean,
   * }}
   */
  let OsSyncPrefs;

  /** @interface */
  class OsSyncBrowserProxy {
    /**
     * Function to invoke when the sync page has been navigated to. This
     * registers the UI as the "active" sync UI.
     */
    didNavigateToOsSyncPage() {}

    /**
     * Function to invoke when leaving the sync page so that the C++ layer can
     * be notified that the sync UI is no longer open.
     */
    didNavigateAwayFromOsSyncPage() {}

    /**
     * Function to invoke when the WebUI wants an update of the OsSyncPrefs.
     */
    sendOsSyncPrefsChanged() {}

    /**
     * Sets whether the OS sync feature should be enabled. Sync will not start
     * until the user either navigates away from the page or closes settings.
     * @param {boolean} enabled
     */
    setOsSyncFeatureEnabled(enabled) {}

    /**
     * Sets which types of data to sync.
     * @param {!settings.OsSyncPrefs} osSyncPrefs
     */
    setOsSyncDatatypes(osSyncPrefs) {}
  }

  /**
   * @implements {settings.OsSyncBrowserProxy}
   */
  class OsSyncBrowserProxyImpl {
    /** @override */
    didNavigateToOsSyncPage() {
      chrome.send('DidNavigateToOsSyncPage');
    }

    /** @override */
    didNavigateAwayFromOsSyncPage() {
      chrome.send('DidNavigateAwayFromOsSyncPage');
    }

    /** @override */
    sendOsSyncPrefsChanged() {
      chrome.send('OsSyncPrefsDispatch');
    }

    /** @override */
    setOsSyncFeatureEnabled(enabled) {
      return chrome.send('SetOsSyncFeatureEnabled', [enabled]);
    }

    /** @override */
    setOsSyncDatatypes(osSyncPrefs) {
      return chrome.send('SetOsSyncDatatypes', [osSyncPrefs]);
    }
  }

  cr.addSingletonGetter(OsSyncBrowserProxyImpl);

  // #cr_define_end
  return {
    OsSyncBrowserProxy,
    OsSyncBrowserProxyImpl,
    OsSyncPrefs,
  };
});