summaryrefslogtreecommitdiffstats
path: root/chromium/chrome/browser/resources/welcome/google_apps/google_app_proxy.js
blob: b4edc677e8aff57e3c137e2c6dd6a88182049cf7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
// Copyright 2018 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('welcome', function() {
  /**
   * NuxGoogleAppsSelections enum.
   * These values are persisted to logs and should not be renumbered or
   * re-used.
   * See tools/metrics/histograms/enums.xml.
   * @enum {number}
   */
  const NuxGoogleAppsSelections = {
    GMAIL_DEPRECATED: 0,
    YOU_TUBE: 1,
    MAPS: 2,
    TRANSLATE: 3,
    NEWS: 4,
    CHROME_WEB_STORE: 5,
  };

  /** @interface */
  class GoogleAppProxy {
    /**
     * Google app IDs are local to the list of Google apps, so their icon must
     * be cached by the handler that provided the IDs.
     * @param {number} appId
     */
    cacheBookmarkIcon(appId) {}

    /**
     * Returns a promise for an array of Google apps.
     * @return {!Promise<!Array<!welcome.BookmarkListItem>>}
     */
    getAppList() {}

    /**
     * @param {number} providerId This should match one of the histogram enum
     *     value for NuxGoogleAppsSelections.
     */
    recordProviderSelected(providerId) {}
  }

  /** @implements {welcome.GoogleAppProxy} */
  class GoogleAppProxyImpl {
    /** @override */
    cacheBookmarkIcon(appId) {
      chrome.send('cacheGoogleAppIcon', [appId]);
    }

    /** @override */
    getAppList() {
      return cr.sendWithPromise('getGoogleAppsList');
    }

    /** @override */
    recordProviderSelected(providerId) {
      chrome.metricsPrivate.recordEnumerationValue(
          'FirstRun.NewUserExperience.GoogleAppsSelection', providerId,
          Object.keys(NuxGoogleAppsSelections).length);
    }
  }

  cr.addSingletonGetter(GoogleAppProxyImpl);

  return {
    GoogleAppProxy: GoogleAppProxy,
    GoogleAppProxyImpl: GoogleAppProxyImpl,
  };
});