Implement networkingPrivate.setWifiTDLSEnabledState

chrome/common/extensions/api/networking_private.json

 // Copyright (c) 2013 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.
 
 [
   {
     "namespace":"networkingPrivate",
     "description": "none",
     "compiler_options": {
       "implemented_in": "chrome/browser/extensions/api/networking_private/networking_private_api.h"
@@ skipping 335 matching lines @@
             "type": "function",
             "parameters": [
               {
                 "name": "encryptedData",
                 "type": "string"
               }
             ],
             "description": "A callback function that receives base64-encoded encrypted data to send to a trusted device."
           }
         ]
+      },
+      {
+        "name": "setWifiTDLSEnabledState",
+        "description": "Enables TDLS for wifi traffic with a specified peer if available.",
+        "parameters": [
+          {
+            "name": "ip_or_mac_address",
+            "type": "string",
+            "description": "The IP or MAC address of the peer with which to enable a TDLS connection."
+          },
+          {
+            "name": "enabled",
+            "type": "boolean",
+            "description": "If true, enable TDLS, otherwise disable TDLS."
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "parameters": [
+              {
+                "name": "status",
+                "type": "string"
+              }
+            ],
+            "description": "A callback function that receives a string with an error or the current TDLS status. 'Failed' indicates that the request failed (e.g. MAC address lookup failed). 'Timeout' indicates that the lookup timed out. Otherwise a valid status is returned (see getWifiTDLSStatus)."
+          }
+        ]
+      },
+      {
+        "name": "getWifiTDLSStatus",
+        "description": "Returns the current TDLS status for the specified peer.",
+        "parameters": [
+          {
+            "name": "ip_or_mac_address",
+            "type": "string",
+            "description": "The IP or MAC address of the peer."
+          },
+          {
+            "name": "callback",
+            "type": "function",
+            "parameters": [
+              {
+                "name": "status",
+                "type": "string"
+              }
+            ],
+            "description": "A callback function that receives a string with the current TDLS status which can be 'Connected', 'Disabled', 'Disconnected', 'Nonexistent', or 'Unknown'"

[asargent_no_longer_on_chrome, 2014/02/14 20:35:08]

I just remembered that you can formally declare the possible values by doing:

"enum": ["Connected", "Disabled", ... etc. ]

here, which has the advantage that you'll get checking of these values for free
and they will also appear in the docs autogeneration.

See chrome/common/extensions/api/management.json /
https://developer.chrome.com/extensions/management.html#type-ExtensionInfo for
one example. 

[stevenjb, 2014/02/14 20:46:59]

Is that:
"type": "enum": ["Connected", "Disabled", ... etc. ]
?

If we change that later will it affect JS code that expects a string? That list
may not be 100% set in stone yet, so I am cautious about using a fixed enum now.

+          }
+        ]
       }
     ],
     "events": [
       {
         "name": "onNetworksChanged",
         "type": "function",
         "description": "Fired when the properties change on any of the networks.  Sends a list of identifiers for networks whose properties have changed.",
         "parameters": [
           {
             "name": "changes",
@@ skipping 10 matching lines @@
           {
             "name": "changes",
             "type": "array",
             "items": { "type": "string" }
           }
         ]
       }
     ]
   }
 ]