Add 'connection' API grouping and 'connected' API method.

docs/source/development.rst

@@ -378,6 +378,22 @@ message, pass in the ``before`` parameter with an empty string value ``''``.
         converse.archive.query(rsm, callback, errback);
     }
 
+The "connection" grouping
+-------------------------
+
+This grouping collects API functions related to the XMPP connection.
+
+connected
+~~~~~~~~~
+
+Returns a boolean value (`true` or `false`) depending on whether there is an
+established connection.
+
+disconnect
+~~~~~~~~~~
+
+Terminates the connection.
+
 
 The "user" grouping
 -------------------

src/converse-api.js

@@ -25,8 +25,13 @@
         'initialize': function (settings, callback) {
             converse.initialize(settings, callback);
         },
-        'disconnect': function () {
-              converse.connection.disconnect();
+        'connection': {
+            'connected': function () {
+                return converse.connection.connected;
+            },
+            'disconnect': function () {
+                converse.connection.disconnect();
+            },
         },
         'user': {
             'logout': function () {