email-service

A package provide an abstraction between multiple email service providers. If one of the services goes down, it will failover to another provider.

Currently supported:

• Mailgun
• Mandrill
• SendGrid

Installation

npm install --save email-service

Usage

MailService will return a Promise.

let sendService = new MailService({
    services: {
        mailgun: {
            apiKey: 'mailgun-apiKey',
            domain: 'mailgun-domain',
        },
        sendgrid: {
            apiKey: 'sendgrid-apiKey'
        },
        mandrill: {
            apiKey: 'sendgrid-apiKey'
        },
        servicesFailoverOrder: {
            'mailgun',
            'mandrill',
            'sendgrid'
        }
    },
});

...

sendService.send(fromEmail, toEmail, subject, content)
    .then(...)
    .catch(...)

Full config is :

{
    services: {
        mailgun: {
            apiKey: '',
            domain: '',
        },
        sendgrid: {
            apiKey: ''
        },
        mandrill: {
            apiKey: ''
        }
    },
    servicesFailoverOrder: [
        'mailgun',
        'mandrill',
        'sendgrid'
    ],
    retryTimes:     3,
}

Testing

create a file ./test/config.json with credentials:

{
  "sendFromEmail":  "",
  "sendToEmail":    "",
  "mailgunApikey":  "",
  "mailgunDomain":  "",
  "mandrillApikey": "",
  "sendgridApikey": "",
  "wrongApiKey":    ""
}

To run tests do:

npm test

TODO

• add to send attachments
• add to send HTML/plain content