Add a alert to BrowserStack utility

Author: Rohan Jain

lib/utils.js

@@ -1,4 +1,7 @@
 var config = require('./config');
+var http = require('http');
+var url = require('url');
+var querystring = require('querystring');
 
 var titleCase = function toTitleCase(str) {
   return str.replace(/\w\S*/g, function (txt) {
@@ -27,7 +30,66 @@ var objectSize = function objectSize (obj) {
     return size;
 };
 
+var alertBrowserStack = function alertBrowserStack (subject, content, params, fn) {
+  var endpoint = config.alert_endpoint || "http://www.browserstack.com/automate/alert";
+  var urlObject = url.parse(endpoint);
+
+  if (typeof params !== 'object') {
+    params = {};
+  }
+
+  if (typeof fn !== 'function') {
+    fn = function() {};
+  }
+
+  params.subject = subject;
+  params.content = content;
+
+  var options = {
+    hostname: urlObject.hostname,
+    port: urlObject.port,
+    path: urlObject.path,
+    method: 'POST',
+    auth: config.username + ":" + config.key
+  };
+
+  var callback = function (res) {
+    var response = "";
+    res.setEncoding( "utf8" );
+    res.on( "data", function( chunk ) {
+      response += chunk;
+    });
+    res.on( "end", function() {
+      if ( res.statusCode !== 200 ) {
+        var message;
+        if ( res.headers[ "content-type" ].indexOf( "json" ) !== -1 ) {
+          var resp = JSON.parse( response );
+          message = resp.message;
+          message += ' - ' + resp.errors.map(function(err){
+            return '`' + err.field + '`' + ' ' + err.code
+          }).join(', ')
+        } else {
+          message = response;
+        }
+        if ( !message && res.statusCode === 403 ) {
+          message = "Forbidden";
+        }
+        fn( new Error( message ) );
+      } else {
+        fn( null, JSON.parse( response ) );
+      }
+    });
+  };
+
+  var request = http.request(options, callback);
+  request.write(querystring.stringify(params));
+  request.end();
+
+  return request;
+}
+
 exports.titleCase = titleCase;
 exports.uuid = uuid;
 exports.browserString = browserString;
 exports.objectSize = objectSize;
+exports.alertBrowserStack = alertBrowserStack;