[Extensions UI] Use developerPrivate API for profile configuration

third_party/closure_compiler/externs/developer_private.js

Index: third_party/closure_compiler/externs/developer_private.js
diff --git a/third_party/closure_compiler/externs/developer_private.js b/third_party/closure_compiler/externs/developer_private.js
index 8359c4457e2c969c645a0215e56a23cde03aed8f..53091a1bcd0723ca5a9bf32047656cc091f051ab 100644
--- a/third_party/closure_compiler/externs/developer_private.js
+++ b/third_party/closure_compiler/externs/developer_private.js
@@ -11,6 +11,7 @@ chrome.developerPrivate = {};
 
 /**
  * @enum {string}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-ItemType
  */
 chrome.developerPrivate.ItemType = {
   hosted_app: 'hosted_app',
@@ -28,6 +29,7 @@ chrome.developerPrivate.ItemType = {
  *   incognito: boolean,
  *   generatedBackgroundPage: boolean
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-ItemInspectView
  */
 var ItemInspectView;
 
@@ -38,6 +40,7 @@ var ItemInspectView;
  *   render_view_id: (string|number),
  *   incognito: boolean
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-InspectOptions
  */
 var InspectOptions;
 
@@ -45,11 +48,13 @@ var InspectOptions;
  * @typedef {{
  *   message: string
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-InstallWarning
  */
 var InstallWarning;
 
 /**
  * @enum {string}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-ExtensionType
  */
 chrome.developerPrivate.ExtensionType = {
   HOSTED_APP: 'HOSTED_APP',
@@ -62,6 +67,7 @@ chrome.developerPrivate.ExtensionType = {
 
 /**
  * @enum {string}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-Location
  */
 chrome.developerPrivate.Location = {
   FROM_STORE: 'FROM_STORE',
@@ -72,6 +78,7 @@ chrome.developerPrivate.Location = {
 
 /**
  * @enum {string}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-ViewType
  */
 chrome.developerPrivate.ViewType = {
   APP_WINDOW: 'APP_WINDOW',
@@ -87,6 +94,7 @@ chrome.developerPrivate.ViewType = {
 
 /**
  * @enum {string}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-ErrorType
  */
 chrome.developerPrivate.ErrorType = {
   MANIFEST: 'MANIFEST',
@@ -95,6 +103,7 @@ chrome.developerPrivate.ErrorType = {
 
 /**
  * @enum {string}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-ErrorLevel
  */
 chrome.developerPrivate.ErrorLevel = {
   LOG: 'LOG',
@@ -104,6 +113,7 @@ chrome.developerPrivate.ErrorLevel = {
 
 /**
  * @enum {string}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-ExtensionState
  */
 chrome.developerPrivate.ExtensionState = {
   ENABLED: 'ENABLED',
@@ -116,6 +126,7 @@ chrome.developerPrivate.ExtensionState = {
  *   isEnabled: boolean,
  *   isActive: boolean
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-AccessModifier
  */
 var AccessModifier;
 
@@ -126,6 +137,7 @@ var AccessModifier;
  *   url: string,
  *   functionName: string
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-StackFrame
  */
 var StackFrame;
 
@@ -139,6 +151,7 @@ var StackFrame;
  *   manifestKey: string,
  *   manifestSpecific: (string|undefined)
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-ManifestError
  */
 var ManifestError;
 
@@ -157,6 +170,7 @@ var ManifestError;
  *   canInspect: boolean,
  *   stackTrace: !Array<StackFrame>
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-RuntimeError
  */
 var RuntimeError;
 
@@ -166,6 +180,7 @@ var RuntimeError;
  *   corruptInstall: boolean,
  *   updateRequired: boolean
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-DisableReasons
  */
 var DisableReasons;
 
@@ -174,6 +189,7 @@ var DisableReasons;
  *   openInTab: boolean,
  *   url: string
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-OptionsPage
  */
 var OptionsPage;
 
@@ -182,6 +198,7 @@ var OptionsPage;
  *   url: string,
  *   specified: boolean
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-HomePage
  */
 var HomePage;
 
@@ -193,6 +210,7 @@ var HomePage;
  *   incognito: boolean,
  *   type: !chrome.developerPrivate.ViewType
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-ExtensionView
  */
 var ExtensionView;
 
@@ -232,11 +250,24 @@ var ExtensionView;
  *   version: string,
  *   views: !Array<ExtensionView>
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-ExtensionInfo
  */
 var ExtensionInfo;
 
 /**
  * @typedef {{
+ *   appInfoDialogEnabled: boolean,
+ *   canLoadUnpacked: boolean,
+ *   inDeveloperMode: boolean,
+ *   isIncognitoAvailable: boolean,
+ *   isSupervised: boolean
+ * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-ProfileInfo
+ */
+var ProfileInfo;
+
+/**
+ * @typedef {{
  *   id: string,
  *   name: string,
  *   version: string,
@@ -265,6 +296,7 @@ var ExtensionInfo;
  *   offline_enabled: boolean,
  *   views: !Array<ItemInspectView>
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-ItemInfo
  */
 var ItemInfo;
 
@@ -273,6 +305,7 @@ var ItemInfo;
  *   includeDisabled: (boolean|undefined),
  *   includeTerminated: (boolean|undefined)
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-GetExtensionsInfoOptions
  */
 var GetExtensionsInfoOptions;
 
@@ -285,13 +318,23 @@ var GetExtensionsInfoOptions;
  *   runOnAllUrls: (boolean|undefined),
  *   showActionButton: (boolean|undefined)
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-ExtensionConfigurationUpdate
  */
 var ExtensionConfigurationUpdate;
 
 /**
  * @typedef {{
+ *   inDeveloperMode: (boolean|undefined)
+ * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-ProfileConfigurationUpdate
+ */
+var ProfileConfigurationUpdate;
+
+/**
+ * @typedef {{
  *   failQuietly: (boolean|undefined)
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-ReloadOptions
  */
 var ReloadOptions;
 
@@ -299,11 +342,13 @@ var ReloadOptions;
  * @typedef {{
  *   failQuietly: (boolean|undefined)
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-LoadUnpackedOptions
  */
 var LoadUnpackedOptions;
 
 /**
  * @enum {string}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-PackStatus
  */
 chrome.developerPrivate.PackStatus = {
   SUCCESS: 'SUCCESS',
@@ -313,6 +358,7 @@ chrome.developerPrivate.PackStatus = {
 
 /**
  * @enum {string}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-FileType
  */
 chrome.developerPrivate.FileType = {
   LOAD: 'LOAD',
@@ -321,6 +367,7 @@ chrome.developerPrivate.FileType = {
 
 /**
  * @enum {string}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-SelectType
  */
 chrome.developerPrivate.SelectType = {
   FILE: 'FILE',
@@ -329,6 +376,7 @@ chrome.developerPrivate.SelectType = {
 
 /**
  * @enum {string}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-EventType
  */
 chrome.developerPrivate.EventType = {
   INSTALLED: 'INSTALLED',
@@ -348,6 +396,7 @@ chrome.developerPrivate.EventType = {
  *   override_flags: number,
  *   status: !chrome.developerPrivate.PackStatus
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-PackDirectoryResponse
  */
 var PackDirectoryResponse;
 
@@ -355,6 +404,7 @@ var PackDirectoryResponse;
  * @typedef {{
  *   name: string
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-ProjectInfo
  */
 var ProjectInfo;
 
@@ -364,6 +414,7 @@ var ProjectInfo;
  *   item_id: string,
  *   extensionInfo: (ExtensionInfo|undefined)
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-EventData
  */
 var EventData;
 
@@ -376,6 +427,7 @@ var EventData;
  *   manifestSpecific: (string|undefined),
  *   lineNumber: (number|undefined)
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-RequestFileSourceProperties
  */
 var RequestFileSourceProperties;
 
@@ -387,6 +439,7 @@ var RequestFileSourceProperties;
  *   title: string,
  *   message: string
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-RequestFileSourceResponse
  */
 var RequestFileSourceResponse;
 
@@ -400,6 +453,7 @@ var RequestFileSourceResponse;
  *   lineNumber: (number|undefined),
  *   columnNumber: (number|undefined)
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-OpenDevToolsProperties
  */
 var OpenDevToolsProperties;
 
@@ -409,6 +463,7 @@ var OpenDevToolsProperties;
  *   errorIds: (!Array<number>|undefined),
  *   type: (!chrome.developerPrivate.ErrorType|undefined)
  * }}
+ * @see https://developer.chrome.com/extensions/developerPrivate#type-DeleteExtensionErrorsProperties
  */
 var DeleteExtensionErrorsProperties;
 
@@ -416,6 +471,7 @@ var DeleteExtensionErrorsProperties;
  * Runs auto update for extensions and apps immediately.
  * @param {function(boolean):void=} callback Called with the boolean result,
  *     true if autoUpdate is successful.
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-autoUpdate
  */
 chrome.developerPrivate.autoUpdate = function(callback) {};
 
@@ -425,6 +481,7 @@ chrome.developerPrivate.autoUpdate = function(callback) {};
  *     returned.
  * @param {function(!Array<ExtensionInfo>):void=} callback Called with
  *     extensions info.
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-getExtensionsInfo
  */
 chrome.developerPrivate.getExtensionsInfo = function(options, callback) {};
 
@@ -432,6 +489,7 @@ chrome.developerPrivate.getExtensionsInfo = function(options, callback) {};
  * Returns information of a particular extension.
  * @param {string} id The id of the extension.
  * @param {function(ExtensionInfo):void=} callback Called with the result.
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-getExtensionInfo
  */
 chrome.developerPrivate.getExtensionInfo = function(id, callback) {};
 
@@ -441,13 +499,32 @@ chrome.developerPrivate.getExtensionInfo = function(id, callback) {};
  * @param {boolean} includeTerminated include terminated items.
  * @param {function(!Array<ItemInfo>):void} callback Called with items info.
  * @deprecated Use getExtensionsInfo
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-getItemsInfo
  */
 chrome.developerPrivate.getItemsInfo = function(includeDisabled, includeTerminated, callback) {};
 
 /**
+ * Returns the current profile's configuration.
+ * @param {function(ProfileInfo):void} callback
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-getProfileConfiguration
+ */
+chrome.developerPrivate.getProfileConfiguration = function(callback) {};
+
+/**
+ * Updates the active profile.
+ * @param {ProfileConfigurationUpdate} update The parameters for updating the
+ *     profile's configuration.  Any     properties omitted from |update| will
+ *     not be changed.
+ * @param {function():void=} callback
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-updateProfileConfiguration
+ */
+chrome.developerPrivate.updateProfileConfiguration = function(update, callback) {};
+
+/**
  * Opens a permissions dialog.
  * @param {string} extensionId The id of the extension to show permissions for.
  * @param {function():void=} callback
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-showPermissionsDialog
  */
 chrome.developerPrivate.showPermissionsDialog = function(extensionId, callback) {};
 
@@ -456,6 +533,7 @@ chrome.developerPrivate.showPermissionsDialog = function(extensionId, callback)
  * @param {string} extensionId The id of the extension to reload.
  * @param {ReloadOptions=} options Additional configuration parameters.
  * @param {function():void=} callback
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-reload
  */
 chrome.developerPrivate.reload = function(extensionId, options, callback) {};
 
@@ -465,6 +543,7 @@ chrome.developerPrivate.reload = function(extensionId, options, callback) {};
  *     extension's configuration.     Any properties omitted from |update| will
  *     not be changed.
  * @param {function():void=} callback
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-updateExtensionConfiguration
  */
 chrome.developerPrivate.updateExtensionConfiguration = function(update, callback) {};
 
@@ -472,6 +551,7 @@ chrome.developerPrivate.updateExtensionConfiguration = function(update, callback
  * Loads a user-selected unpacked item.
  * @param {LoadUnpackedOptions=} options Additional configuration parameters.
  * @param {function():void=} callback
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-loadUnpacked
  */
 chrome.developerPrivate.loadUnpacked = function(options, callback) {};
 
@@ -479,6 +559,7 @@ chrome.developerPrivate.loadUnpacked = function(options, callback) {};
  * Loads an extension / app.
  * @param {Object} directory The directory to load the extension from.
  * @param {function(string):void} callback
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-loadDirectory
  */
 chrome.developerPrivate.loadDirectory = function(directory, callback) {};
 
@@ -490,6 +571,7 @@ chrome.developerPrivate.loadDirectory = function(directory, callback) {};
  *     example, pem type is for private key and load type is for an unpacked
  *     item.
  * @param {function(string):void} callback called with selected item's path.
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-choosePath
  */
 chrome.developerPrivate.choosePath = function(selectType, fileType, callback) {};
 
@@ -500,12 +582,14 @@ chrome.developerPrivate.choosePath = function(selectType, fileType, callback) {}
  * @param {number=} flags Special flags to apply to the loading process, if any.
  * @param {function(PackDirectoryResponse):void=} callback called with the
  *     success result string.
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-packDirectory
  */
 chrome.developerPrivate.packDirectory = function(path, privateKeyPath, flags, callback) {};
 
 /**
  * Returns true if the profile is managed.
  * @param {function(boolean):void} callback
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-isProfileManaged
  */
 chrome.developerPrivate.isProfileManaged = function(callback) {};
 
@@ -514,6 +598,7 @@ chrome.developerPrivate.isProfileManaged = function(callback) {};
  * an error.
  * @param {RequestFileSourceProperties} properties
  * @param {function(RequestFileSourceResponse):void} callback
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-requestFileSource
  */
 chrome.developerPrivate.requestFileSource = function(properties, callback) {};
 
@@ -521,6 +606,7 @@ chrome.developerPrivate.requestFileSource = function(properties, callback) {};
  * Open the developer tools to focus on a particular error.
  * @param {OpenDevToolsProperties} properties
  * @param {function():void=} callback
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-openDevTools
  */
 chrome.developerPrivate.openDevTools = function(properties, callback) {};
 
@@ -528,6 +614,7 @@ chrome.developerPrivate.openDevTools = function(properties, callback) {};
  * Delete reported extension erors.
  * @param {DeleteExtensionErrorsProperties} properties
  * @param {function():void=} callback
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-deleteExtensionErrors
  */
 chrome.developerPrivate.deleteExtensionErrors = function(properties, callback) {};
 
@@ -536,6 +623,7 @@ chrome.developerPrivate.deleteExtensionErrors = function(properties, callback) {
  * @param {boolean} enabled
  * @param {function():void=} callback
  * @deprecated Use management.setEnabled
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-enable
  */
 chrome.developerPrivate.enable = function(id, enabled, callback) {};
 
@@ -544,6 +632,7 @@ chrome.developerPrivate.enable = function(id, enabled, callback) {};
  * @param {boolean} allow
  * @param {function():void=} callback
  * @deprecated Use updateExtensionConfiguration
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-allowIncognito
  */
 chrome.developerPrivate.allowIncognito = function(extensionId, allow, callback) {};
 
@@ -552,6 +641,7 @@ chrome.developerPrivate.allowIncognito = function(extensionId, allow, callback)
  * @param {boolean} allow
  * @param {function():void=} callback
  * @deprecated Use updateExtensionConfiguration
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-allowFileAccess
  */
 chrome.developerPrivate.allowFileAccess = function(extensionId, allow, callback) {};
 
@@ -559,8 +649,13 @@ chrome.developerPrivate.allowFileAccess = function(extensionId, allow, callback)
  * @param {InspectOptions} options
  * @param {function():void=} callback
  * @deprecated Use openDevTools
+ * @see https://developer.chrome.com/extensions/developerPrivate#method-inspect
  */
 chrome.developerPrivate.inspect = function(options, callback) {};
 
-/** @type {!ChromeEvent} */
+/**
+ * Fired when a item state is changed.
+ * @type {!ChromeEvent}
+ * @see https://developer.chrome.com/extensions/developerPrivate#event-onItemStateChanged
+ */
 chrome.developerPrivate.onItemStateChanged;