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 ONC documentation for descriptions of properties.
 // 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? Name;
+    DOMString? Username;
+    DOMString? Password;
+  };
+
+  dictionary CellularConfigProperties {
+    boolean? AutoConnect;
+    APNProperties? APN;
+  };
+
+  dictionary CellularStateProperties {
+    long? SignalStrength;
+    boolean? OutOfCredits;
+    DOMString? RoamingState;
+    ActivationStateType? ActivationState;
+    DOMString? NetworkTechnology;
+  };
+
+  dictionary EthernetStateProperties {
+    DOMString? Authentication;
+  };
+
+  dictionary IPConfigProperties {
+    DOMString? Gateway;
+    DOMString? IPAddress;
+    DOMString[]? NameServers;
+    DOMString? Type;
+    long? RoutingPrefix;
+  };
+
+  dictionary IPSecProperties {
+    DOMString? AuthenticationType;
+  };
+
+  dictionary VPNConfigProperties {
+    boolean? AutoConnect;
+    DOMString? Type;
+    DOMString? Host;
+  };
+
+  dictionary VPNStateProperties {
+    DOMString? Type;
+    IPSecProperties? IPsec;
+  };
+
+  dictionary WiFiConfigProperties {
+    boolean? AutoConnect;
+  };
+
+  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;
+  };
+

[asargent_no_longer_on_chrome, 2015/03/26 20:05:40]

nit: usually the names for members of a dictionary are capitalized fooBar (eg do
not have the first letter capitalized) - do they need to have the first letter
capitalized for compatibility with the existing API? If not, please change. 

[stevenjb, 2015/03/27 17:03:21]

These names need to match the ONC spec. I will clarify that in the top level
comment. 

   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 38 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 GetEnabledNetwrokTypesCallback = 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 identifier of the network to get properties for.
     // |callback|: Returns the properties of the network.
     static void getProperties(DOMString networkGuid,
@@ skipping 18 matching lines @@
     // |networkGuid|: The identifier of the network to get properties for.
     // |callback|: Returns the managed properties of the network.
     static void getState(DOMString networkGuid,
                          GetStatePropertiesCallback callback);
 
     // Sets the properties of the network with id networkGuid.
     // |networkGuid|: The identifier of the network to set properties for.
     // |properties|: The ONC 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 ONC properties to configure the new network with.
     // |callback|: Returns the identifier of the created network.
     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.
     static void forgetNetwork(DOMString networkGuid,
                               optional VoidCallback callback);
 
@@ skipping 116 matching lines @@
     // Fired when the list of networks has changed.  Sends a complete list of
     // identifiers 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);
   };
 };