smtpapi

Build SendGrid X-SMTPAPI headers in nodejs.

smtpapi-nodejs

This node module allows you to quickly and more easily generate SendGrid X-SMTPAPI headers.

var smtpapi   = require('smtpapi');
var header    = new smtpapi();
header.addTo('you@youremail.com');
header.setUniqueArgs({cow: 'chicken'});
 
var smtpapi_header_string = header.jsonString();

See this for more information on the available X-SMTPAPI custom handling instructions.

The following recommended installation requires npm. If you are unfamiliar with npm, see the npm docs. Npm comes installed with Node.js since node version 0.8.x therefore you likely already have it.

Add the following to your package.json file:

{
  ...
  "dependencies": {
    ...
    "smtpapi": "1.1.0"
  }
}

Install smtpapi-nodejs and its dependencies:

npm install
var smtpapi   = require('smtpapi');
var header    = new smtpapi();

This gives you back the stringified json formatted X-SMTPAPI header. Use this with your smtp client of choice.

var smtpapi   = require('smtpapi');
var header    = new smtpapi();
header.jsonString();
var header     = new smtpapi();
header.addTo('you@youremail.com');
header.addTo('other@otheremail.com');
var header     = new smtpapi();
header.setTos(['you@youremail.com', 'other@otheremail.com');
var header     = new smtpapi();
header.addSubstitution('keep', ['secret']);
header.addSubstitution('other', ['one', 'two']);
var header     = new smtpapi();
header.setSubstitutions({'keep': ['secret'], 'other': ['one', 'two']});
var header     = new smtpapi();
header.addUniqueArg('cat', 'dogs');
var header     = new smtpapi();
header.setUniqueArgs({cow: 'chicken'});
header.setUniqueArgs({dad: 'proud'});
var header     = new smtpapi();
header.addCategory('tactics');
header.addCategory('advanced');
var header     = new smtpapi();
header.setCategories(['tactics', 'advanced']);
var header     = new smtpapi();
header.addSection('-charge-', 'This ship is useless.');
var header     = new smtpapi();
header.setSections({'-charge-': 'This ship is useless.', '-other': 'Another section here'});

You can add filter settings one at a time.

var header     = new smtpapi();
header.addFilter('footer', 'enable', 1);
header.addFilter('footer', 'text/html', '<strong>boo</strong>');

You can set a filter using an object literal.

var header     = new smtpapi();
header.setFilters({
  'footer': {
    'setting': {
      'enable': 1,
      'text/plain': 'You can haz footers!'
    }
  }
});

You can set the send_at scheduling param using an UNIX timestamp.

var header     = new smtpapi();
header.setSendAt(1409348513);

You can set the send_each_at scheduling param using a list of UNIX timestamps.

var header     = new smtpapi();
header.setSendEachAt([1409348513, 14093485134]);

You can append one or more send_each_at scheduling param(s) to the existing ones using an UNIX timestamp.

var header     = new smtpapi();
header.setSendEachAt([1409348511, 14093485132]);
header.addSendEachAt(1409348513]);
header.addSendEachAt(14093485134);

You can set the ASM Group ID.

var header     = new smtpapi();
header.setASMGroupID(123);

The following example builds the X-SMTPAPI headers and adds them to nodemailer. Nodemailer then sends the email through SendGrid. You can use this same code in your application or optionally you can use sendgrid-nodejs.

var nodemailer = require('nodemailer');
var smtpapi    = require('smtpapi');
 
// Build the smtpapi header 
var header = new smtpapi();
header.addTo('you@youremail.com');
header.setUniqueArgs({cow: 'chicken'});
 
// Add the smtpapi header to the general headers 
var headers    = { 'x-smtpapi': header.jsonString() };
 
// Use nodemailer to send the email 
var settings  = {
  host: "smtp.sendgrid.net",
  port: parseInt(587, 10),
  requiresAuth: true,
  auth: {
    user: "sendgrid_username",
    pass: "sendgrid_password"
  }
};
var smtpTransport = nodemailer.createTransport(settings);
 
var mailOptions = {
  from:     "Fred Foo <foo@blurdybloop.com>",
  to:       "bar@blurdybloop.com",
  subject:  "Hello",
  text:     "Hello world",
  html:     "<b>Hello world</b>",
  headers:  headers
}
 
smtpTransport.sendMail(mailOptions, function(errorresponse) {
  smtpTransport.close();
 
  if (error) {
    console.log(error);
  } else {
    console.log("Message sent: " + response.message);
  }
});
  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request
npm test
```