fastify-mail

Fastify nodemailer plugin, with this you can share the same nodemailer transporter in every part of your server.

Under the hood the it wraps nodemailer transporter and the options that you pass to register will be passed to the transporter. For configuration/usage details please check the nodemailer documentation.

Install

npm i fastify-mail --save

yarn add fastify-mail

Versions

The plugin supports the following Fastify and Nodemailer versions. Please refer to corresponding branch in PR and issues.

version | branch | fastify | nodemailer | End of support --------|--------|---------|------------|---------------
1.x | [maain](https://github.com/Zebedeu/fastify-mail | 4.x | 6.x |

Usage

Add it to you project with register and you are done! You can access the transporter via fastify.nodemailer and sendMail() via fastify.nodemailer.sendMail().

const fastify = require('fastify')()

fastify.register(require('fastify-mail'), {
  pool: true,
  host: 'smtp.example.com',
  port: 465,
  secure: true, // use TLS
  auth: {
      user: 'username',
      pass: 'password'
  }
})

fastify.get('/sendmail/:email', (req, reply, next) => {
  let { nodemailer } = fastify
  let recipient = req.params.email

  nodemailer.sendMail({
    from: '[email protected]',
    to: recipient,
    subject: 'foo',
    text: 'bar'
  }, (err, info) => {
    if (err) next(err)
    reply.send({
      messageId: info.messageId
    })
  })
})

fastify.listen(3000, err => {
  if (err) throw err
  console.log(`server listening on ${fastify.server.address().port}`)
})

New: You can also access the transporter via reply.nodemailer.sendMail().

fastify.get('/sendmail/:email', (req, reply, next) => {
  let recipient = req.params.email

  reply.nodemailer.sendMail({
    from: '[email protected]',
    to: recipient,
    subject: 'foo',
    text: 'bar'
  }, (err, info) => {
    if (err) next(err)
    reply.send({
      messageId: info.messageId
    })
  })
})

Custom transports

By default, passing an object as options to the plugin will configure nodemailer's main transport (SMTP).

If you need a custom transport, simply initialize the transport, and pass it to the plugin instead of an options object. For example, using the nodemailer-sparkpost-transport:

const fastify = require('fastify')()

const sparkPostTransport = require('nodemailer-sparkpost-transport')

const sparkPostTransportOptions = {
  sparkPostApiKey: 'MY_API_KEY'
}

fastify.register(require('fastify-mail'), sparkPostTransport(sparkPostTransportOptions))

// or

const sparkPostTransportInstance = sparkPostTransport(sparkPostTransportOptions)

fastify.register(require('fastify-mail'), sparkPostTransportInstance)

Then, later:

fastify.get('/sendmail', (req, reply, next) => {

  const sendOptions = {
    content: {
      template_id: 'my_template_id',
      use_draft_template: false
    },
    "recipients": [
      {
        "address": {
          "email": "[email protected]",
          "name": "John Doe"
        },
        "substitution_data": {
          username: "John Doe"
        }
      }
    ]
  };

  fastify.nodemailer.sendMail(sendOptions, (err, info) => {
    if (err) next(err)
    reply.send({
      messageId: info.messageId
    })
  })

})

Multiple transports

Since fastify-mail fully supports Fastify's built-in encapsulation feature, all you need to do is register this plugin with your custom transporter and the corresponding route in a new context.

License

Licensed under MIT.