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: 'sender@example.com',
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: 'sender@example.com',
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": "sender@example.com",
"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.