Add types to networkigPrivate IDL

extensions/common/api/networking_private.idl

 // Copyright 2015 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.
 
 // The <code>chrome.networkingPrivate</code> API is used for configuring
 // network connections (Cellular, Ethernet, VPN, WiFi or WiMAX). This private
 // API is only valid if called from a browser or app associated with the
 // primary user. See the Open Network Configuration (ONC) documentation for
 // descriptions of properties: 
 // <a href="https://code.google.com/p/chromium/codesearch#chromium/src/components/onc/docs/onc_spec.html">
 // src/components/onc/docs/onc_spec.html</a>, or the 
 // <a href="http://www.chromium.org/chromium-os/chromiumos-design-docs/open-network-configuration">
 // Open Network Configuration</a> page at chromium.org.
-//
+// <br><br>
+// NOTE: Most dictionary properties and enum values use UpperCamelCase to match
+// the ONC spec instead of the JavaScript lowerCamelCase convention.
+// <br><br>
+// "State" properties describe just the ONC properties returned by
+// $(ref:networkingPrivate.getState) and $(ref:networkingPrivate.getNetworks).
+// <br><br>
+// "Config" properties describe just the ONC properties that can be configured
+// through this API. NOTE: Not all configuration properties are exposed at this 
+// time, only those currently required by the Chrome Settings UI.
+// TODO(stevenjb): Provide all configuration properties and types, 
+// crbug.com/380937.
+// <br><br>
 // TODO(stevenjb/pneubeck): Merge the ONC documentation with this document and
 // use it as the ONC specification.
 
 namespace networkingPrivate {
+  enum ActivationStateType {
+    Activated, Activating, NotActivated, PartiallyActivated
+  };
+
   enum CaptivePortalStatus {
     Unknown, Offline, Online, Portal, ProxyAuthRequired
   };
 
+  enum ConnectionStateType {
+    Connected, Connecting, NotConnected
+  };
+
+  enum IPConfigType {
+    DHCP, Static
+  };
+
   enum NetworkType {
     All, Bluetooth, Cellular, Ethernet, VPN, Wireless, WiFi, WiMAX
   };
 
+  dictionary APNProperties {
+    DOMString? AccessPointName;
+    DOMString? Language;
+    DOMString? LocalizedName;
+    DOMString? Name;
+    DOMString? Password;
+    DOMString? Username;
+  };
+
+  dictionary CellularConfigProperties {
+    boolean? AutoConnect;
+    APNProperties? APN;
+  };
+
+  dictionary CellularStateProperties {
+    ActivationStateType? ActivationState;
+    DOMString? NetworkTechnology;
+    DOMString? RoamingState;
+    long? SignalStrength;
+  };
+
+  dictionary EthernetStateProperties {
+    DOMString Authentication;
+  };
+
+  dictionary IPConfigProperties {
+    DOMString? Gateway;
+    DOMString? IPAddress;
+    DOMString[]? NameServers;
+    long? RoutingPrefix;
+    DOMString? Type;
+    DOMString? WebProxyAutoDiscoveryUrl;
+  };
+
+  dictionary IPSecProperties {
+    DOMString AuthenticationType;
+  };
+
+  dictionary ThirdPartyVPNProperties {
+    DOMString ExtensionID;
+  };
+    
+  dictionary VPNConfigProperties {
+    boolean? AutoConnect;
+    DOMString? Host;
+    ThirdPartyVPNProperties? ThirdPartyVPN;
+    DOMString? Type;
+  };
+
+  dictionary VPNStateProperties {
+    DOMString Type;
+    IPSecProperties? IPsec;
+    ThirdPartyVPNProperties? ThirdPartyVPN;
+  };
+
+  dictionary WiFiConfigProperties {
+    boolean? AutoConnect;
+    DOMString? HexSSID;
+    boolean? HiddenSSID;
+    DOMString? Passphrase;
+    DOMString? SSID;
+    DOMString? Security;
+  };
+
+  dictionary WiFiStateProperties {
+    DOMString Security;
+    long? SignalStrength;
+  };
+
+  dictionary WiMaxConfigProperties {
+    boolean? AutoConnect;
+  };
+
+  dictionary WiMAXStateProperties {
+    long? SignalStrength;
+  };
+
+  dictionary NetworkConfigProperties {
+    CellularConfigProperties? Cellular;
+    DOMString? GUID;
+    IPConfigType? IPAddressConfigType;
+    DOMString? Name;
+    IPConfigType? NameServersConfigType;
+    long? Priority;
+    IPConfigProperties? StaticIPConfig;
+    NetworkType? Type;
+    VPNConfigProperties? VPN;
+    WiFiConfigProperties? WiFi;
+    WiMaxConfigProperties? WiMAX;
+  };
+
+  dictionary NetworkStateProperties {
+    CellularStateProperties? Cellular;
+    boolean? Connectable;
+    ConnectionStateType? ConnectionState;
+    EthernetStateProperties? Ethernet;
+    DOMString? ErrorState;
+    DOMString GUID;
+    DOMString? Name;
+    long? Priority;
+    DOMString? Source;
+    NetworkType Type;
+    VPNStateProperties? VPN;
+    WiFiStateProperties? WiFi;
+    WiMAXStateProperties? WiMAX;
+  };
+
   dictionary VerificationProperties {
     // A string containing a PEM-encoded (including the 'BEGIN CERTIFICATE'
     // header and 'END CERTIFICATE' footer) X.509 certificate for use in
     // verifying the signed data.
     DOMString certificate;
 
     // An array of PEM-encoded X.509 intermediate certificate authority
     // certificates. Each PEM-encoded certificate is expected to have the
     // 'BEGIN CERTIFICATE' header and 'END CERTIFICATE' footer.
     DOMString[]? intermediateCertificates;
@@ skipping 39 matching lines @@
     long? limit;
   };
 
   callback VoidCallback = void();
   callback BooleanCallback = void(boolean result);
   callback StringCallback = void(DOMString result);
   // TODO(stevenjb): Use NetworkProperties for |result| once defined.
   callback GetPropertiesCallback = void(object result);
   // TODO(stevenjb): Use ManagedNetworkProperties for |result| once defined.
   callback GetManagedPropertiesCallback = void(object result);
-  callback GetStatePropertiesCallback = void(object result);
-  callback GetNetworksCallback = void(object[] result);
+  callback GetStatePropertiesCallback = void(NetworkStateProperties result);
+  callback GetNetworksCallback = void(NetworkStateProperties[] result);
   callback GetEnabledNetworkTypesCallback = void(NetworkType[] result);
   callback CaptivePortalStatusCallback = void(CaptivePortalStatus result);
 
   // These functions all report failures via chrome.runtime.lastError.
   interface Functions {
     // Gets all the properties of the network with id networkGuid. Includes all
     // properties of the network (read-only and read/write values).
     // |networkGuid|: The GUID of the network to get properties for.
     // |callback|: Called with the network properties when received.
     static void getProperties(DOMString networkGuid,
                               GetPropertiesCallback callback);
 
     // Gets the merged properties of the network with id networkGuid from the
     // sources: User settings, shared settings, user policy, device policy and
     // the currently active settings.
     // |networkGuid|: The GUID of the network to get properties for.
     // |callback|: Called with the managed network properties when received.
     static void getManagedProperties(DOMString networkGuid,
                                      GetManagedPropertiesCallback callback);
 
     // Gets the cached read-only properties of the network with id networkGuid.
     // This is meant to be a higher performance function than
     // $(ref:getProperties), which requires a round trip to query the networking
     // subsystem. The following properties are returned for all networks: GUID,
     // Type, Name, WiFi.Security. Additional properties are provided for visible
     // networks: ConnectionState, ErrorState, WiFi.SignalStrength,
     // Cellular.NetworkTechnology, Cellular.ActivationState,
-    // Cellular.RoamingState, Cellular.OutOfCredits.
+    // Cellular.RoamingState.
     // |networkGuid|: The GUID of the network to get properties for.
     // |callback|: Called immediately with the network state properties.
     static void getState(DOMString networkGuid,
                          GetStatePropertiesCallback callback);
 
     // Sets the properties of the network with id networkGuid.
     // |networkGuid|: The GUID of the network to set properties for.
     // |properties|: The properties to set.
     // |callback|: Called when the operation has completed.
     static void setProperties(DOMString networkGuid,
-                              object properties,
+                              NetworkConfigProperties properties,
                               optional VoidCallback callback);
 
     // Creates a new network configuration from properties. If a matching
     // configured network already exists, this will fail. Otherwise returns the
     // guid of the new network.
     // |shared|: If true, share this network configuration with other users.
     // |properties|: The properties to configure the new network with.
     // |callback|: Called with the GUID for the new network configuration once
     //     the network has been created.
     static void createNetwork(boolean shared,
-                              object properties,
+                              NetworkConfigProperties properties,
                               optional StringCallback callback);
 
     // Forgets a network configuration by clearing any configured properties for
     // the network with GUID 'networkGuid'. This may also include any other
     // networks with matching identifiers (e.g. WiFi SSID and Security). If no
     // such configuration exists, an error will be set and the operation will
     // fail.
     // |networkGuid|: The GUID of the network to forget.
     // |callback|: Called when the operation has completed.
     static void forgetNetwork(DOMString networkGuid,
@@ skipping 129 matching lines @@
     // Fired when the list of networks has changed.  Sends a complete list of
     // GUIDs for all the current networks.
     static void onNetworkListChanged(DOMString[] changes);
 
     // Fired when a portal detection for a network completes. Sends the guid of
     // the network and the corresponding captive portal status.
     static void onPortalDetectionCompleted(DOMString networkGuid,
                                            CaptivePortalStatus status);
   };
 };