New API

.eslintignore

@@ -0,0 +1,3 @@
+node_modules
+examples
+test

index.js

@@ -1,2 +1,2 @@
-exports = module.exports = require("./lib/sendgrid");
-exports.mail = require("./lib/helpers/mail/mail.js")
+exports = module.exports = require('./lib/sendgrid');
+exports.mail = require('./lib/helpers/mail/mail.js');

lib/helpers/error.js

@@ -0,0 +1,20 @@
+'use strict';
+
+//Error constructor
+function SendGridError(message) {
+  this.message = message;
+  if (Error.captureStackTrace) {
+    Error.captureStackTrace(this, this.constructor);
+  }
+  else {
+    this.stack = (new Error()).stack;
+  }
+}
+
+//Extend prototype
+SendGridError.prototype = new Error();
+SendGridError.prototype.constructor = SendGridError;
+SendGridError.prototype.name = 'SendGridError';
+
+//Export
+module.exports = SendGridError;

lib/sendgrid.js

@@ -2,11 +2,27 @@
 'use strict';
 var package_json = require('./../package.json');
 var emptyRequest = require('sendgrid-rest').emptyRequest;
+var SendGridError = require('./helpers/error');
+
+//Helper to check if response is valid
+function isValidResponse(response) {
+  return (
+    response &&
+    response.statusCode &&
+    response.statusCode >= 200 &&
+    response.statusCode <= 299
+  );
+}
+
+//Helper to get a new empty request
+function getEmptyRequest() {
+  return JSON.parse(JSON.stringify(emptyRequest));
+}
 
 // SendGrid allows for quick and easy access to the v3 Web API
 function SendGrid(apiKey, host, globalHeaders) {
   var Client = require('sendgrid-rest').Client;
-  var globalRequest = this.emptyRequest();
+  var globalRequest = getEmptyRequest();
   globalRequest.host = host || 'api.sendgrid.com';
   globalRequest.headers['Authorization'] = 'Bearer '.concat(apiKey);
   globalRequest.headers['Accept'] = 'application/json';
@@ -21,23 +37,48 @@ function SendGrid(apiKey, host, globalHeaders) {
   }
   var client = new Client(globalRequest);
 
-  this.emptyRequest = function() {
-    return JSON.parse(JSON.stringify(emptyRequest));
-  };
+  this.emptyRequest = getEmptyRequest;
 
   // Interact with the API with this function
   this.API = function(request, callback) {
+
+    //If no callback provided, we will return a promise
+    if (!callback) {
+      if (!SendGrid.Promise) {
+        throw new SendGridError('Promise API not supported');
+      }
+      return new SendGrid.Promise(function(resolve, reject) {
+        client.API(request, function(response) {
+          if (isValidResponse(response)) {
+            resolve(response);
+          }
+          else {
+            reject(response);
+          }
+        });
+      });
+    }
+
+    //Use callback
     client.API(request, function(response) {
-      callback(response);
+      if (isValidResponse(response)) {
+        callback(null, response);
+      }
+      else {
+        var error = new SendGridError('Response error');
+        callback(error, response);
+      }
     });
   };
 
   this.globalRequest = globalRequest;
   return this;
 }
 
-module.exports =
-{
+//Try to use native promises by default
+SendGrid.Promise = Promise || null;
+
+module.exports = {
   SendGrid: SendGrid,
-  emptyRequest: SendGrid.emptyRequest(),
+  emptyRequest: getEmptyRequest(),
 };

package.json

@@ -7,7 +7,8 @@
     "Brandon West <brandon.west@sendgrid.com>",
     "Scott Motte <scott.motte@sendgrid.com>",
     "Robert Acosta <robert.acosta@sendgrid.com>",
-    "Elmer Thomas <elmer.thomas@sendgrid.com>"
+    "Elmer Thomas <elmer.thomas@sendgrid.com>",
+    "Adam Buczynski <me@adambuczynski.com>"
   ],
   "name": "sendgrid",
   "description": "Official SendGrid NodeJS library.",
@@ -25,12 +26,13 @@
   },
   "devDependencies": {
     "chai": "^3.5.0",
-    "eslint": "^2.7.0",
+    "eslint": "^3.1.0",
     "eslint-config-standard": "^5.1.0",
     "eslint-plugin-standard": "^1.3.2",
     "mocha": "^2.4.5"
   },
   "scripts": {
+    "pretest": "eslint . --fix",
     "test": "mocha"
   },
   "tags": [