Attachments support

README.md

@@ -49,6 +49,12 @@ transport.sendMail({
 }, /* ... */);
 ```
 
+## Attachments
+
+The content of attachments **must** be a base64 encoded string.
+Examples of this can be found in the test file.
+
+
 ## Sending Images to Mandrill
 
 To send images as attachments:

lib/mandrill-transport.js

@@ -23,6 +23,27 @@ MandrillTransport.prototype.send = function(mail, callback) {
   var bccAddrs = addressparser(data.bcc) || [];
   var fromAddr = addressparser(data.from)[0] || {};
   var mandrillOptions = data.mandrillOptions || {};
+  var attachments = [];
+
+  // convert attachments passed to nodemailer to the structure used by mandrill
+  if (mail.message && mail.message.childNodes) {
+    mail.message.childNodes.forEach(function(node) {
+      var headersAsMap = {};
+
+      node._headers && node._headers.forEach(function(headerEntry) {
+        headersAsMap[headerEntry.key] = headerEntry.value;
+      });
+
+      // a node is an attachment with header 'Content-Disposition' : 'attachment'
+      if (headersAsMap['Content-Disposition']  === 'attachment') {
+        attachments.push({
+          'name': node.filename,
+          'type': headersAsMap['Content-Type'],
+          'content': node.content
+        });
+      }
+    });
+  }
 
   var payload = extend(true, {
     async: true,
@@ -53,7 +74,8 @@ MandrillTransport.prototype.send = function(mail, callback) {
       subject: data.subject,
       headers: data.headers,
       text: data.text,
-      html: data.html
+      html: data.html,
+      attachments: attachments
     }
   }, mandrillOptions);
 

package.json

@@ -28,6 +28,7 @@
   "devDependencies": {
     "chai": "^3.5.0",
     "mocha": "^2.4.5",
+    "nodemailer": "^2.2.1",
     "sinon": "^1.17.3"
   }
 }

test/mandrill-transport.js

@@ -1,11 +1,9 @@
 'use strict';
 
-var sinon = require('sinon');
-var expect = require('chai').expect;
-
-var mandrillTransport = require('../');
-
-var packageData = require('../package.json');
+var sinon = require('sinon'),
+  expect = require('chai').expect,
+  mandrillTransport = require('../'),
+  packageData = require('../package.json');
 
 describe('MandrillTransport', function() {
   it('should expose name and version', function() {
@@ -14,7 +12,7 @@ describe('MandrillTransport', function() {
     expect(transport.version).to.equal(packageData.version);
   });
 
-  describe('#send', function(done) {
+  describe('#send', function() {
     var transport = mandrillTransport();
     var client = transport.mandrillClient;
 
@@ -165,4 +163,71 @@ describe('MandrillTransport', function() {
       });
     });
   });
+
+  describe('#send attachments usage', function() {
+    var nodemailer = require('nodemailer'),
+      transport = mandrillTransport(),
+      client = transport.mandrillClient,
+      wrappedTransport = nodemailer.createTransport(transport),
+      sendOptions;
+
+    before(function() {
+      sinon.stub(client.messages, 'send', function(options, cb) {
+        sendOptions = options;
+        cb([]);
+      });
+    });
+
+    beforeEach(function() {
+      sendOptions = {};
+    });
+
+    after(function() {
+      client.messages.send.restore();
+    });
+
+    it('attachments object', function(done) {
+      wrappedTransport.sendMail({
+        attachments: [
+          {
+            filename: 'bufferIsABase64.txt',
+            content: new Buffer('hello world!', 'utf-8')
+          },
+          {
+            filename: 'text.csv',
+            content: new Buffer('hello;world!\n1;2','utf-8'),
+            contentType: 'text/csv'
+          },
+          {
+            filename: 'encoded.txt',
+            content: new Buffer('i am base64', 'utf-8').toString('base64'),
+            encoding: 'base64'
+          },
+          {   // data uri as an attachment
+            path: 'data:text/plain;base64,' + new Buffer('HELLOWORLD', 'utf-8').toString('base64')
+          }
+        ]
+      }, function(err) {
+        expect(err).to.be.null;
+        expect(sendOptions.message.attachments).to.have.lengthOf(4);
+
+        expect(sendOptions.message.attachments[0].name).to.equal('bufferIsABase64.txt');
+        expect(sendOptions.message.attachments[0].type).to.equal('text/plain');
+        expect(new Buffer(sendOptions.message.attachments[0].content, 'base64').toString('utf-8')).to.equal('hello world!');
+
+        expect(sendOptions.message.attachments[1].name).to.equal('text.csv');
+        expect(sendOptions.message.attachments[1].type).to.equal('text/csv');
+        expect(new Buffer(sendOptions.message.attachments[1].content, 'base64').toString('utf-8')).to.equal('hello;world!\n1;2');
+
+        expect(sendOptions.message.attachments[2].name).to.equal('encoded.txt');
+        expect(sendOptions.message.attachments[2].type).to.equal('text/plain');
+        expect(new Buffer(sendOptions.message.attachments[2].content, 'base64').toString('utf-8')).to.equal('i am base64');
+
+        expect(sendOptions.message.attachments[3].name).to.equal('attachment-4.txt');
+        expect(sendOptions.message.attachments[3].type).to.equal('text/plain');
+        expect(new Buffer(sendOptions.message.attachments[3].content, 'base64').toString('utf-8')).to.equal('HELLOWORLD');
+        done();
+      });
+    });
+  });
 });