Feathers mailer service
npm install feathers-mailer
!Libraries.io dependency status for GitHub repo

> Feathers mailer service using nodemailer
``shell`
npm install feathers-mailer --save
If using a transport plugin, install the respective module.
`ts
import { Service } = from 'feathers-mailer';
app.use('/emails', new Service(transport, defaults));
`
- transport can be either SMTP options or a transport plugin with associated options.defaults
- is an object that defines default values for mail options.
service.create is a thin wrapper for transporter.sendMail, accepting body and returning a promise.
See here for possible fields of body.
`js
import { Service } from "feathers-mailer";
import nodemailer from "nodemailer";
(async function (app) {
const account = await nodemailer.createTestAccount(); // internet required
const transporter = {
host: account.smtp.host,
port: account.smtp.port,
secure: account.smtp.secure, // 487 only
requireTLS: true,
auth: {
user: account.user, // generated ethereal user
pass: account.pass, // generated ethereal password
},
};
// Register service and setting default From Email
app.use("mailer", new Service(transporter, { from: account.user }));
// Use the service
const email = {
to: "president@mars.com",
subject: "SMTP test",
html: "This is the email body",
};
await app.service("mailer").create(email);
console.log(Preview URL: ${nodemailer.getTestMessageUrl(info)});`
})(app);
`js
import { Service } from "feathers-mailer";
import mandrill from "nodemailer-mandrill-transport";
// Register the service, see below for an example
app.use(
"/mailer",
new Service(
mandrill({
auth: {
apiKey: process.env.MANDRILL_API_KEY,
},
})
)
);
// Use the service
const email = {
from: "FROM_EMAIL",
to: "TO_EMAIL",
subject: "Mandrill test",
html: "This is the email body",
};
app
.service("mailer")
.create(email)
.then(function (result) {
console.log("Sent email", result);
})
.catch((err) => {
console.log(err);
});
`
1. Go to https://easydmarc.com/tools/DKIM-record-generator to generate a DKIM record. In the form, enter the domain name (equal to the
from address domain), and something to use as a selector e.g. feathersMailer.
2. Ask a network administrator to publish the record which is generated in the domain.
3. Ensure the record is active using https://easydmarc.com/tools/dkim-lookup. Once the test passes, continue (it might need time to replicate across the web)
4. Add the following information to the email constance defined in the example above, so it becomes like this
`js
const email = {
to: 'president@mars.com',
subject: 'SMTP test',
html: 'This is the email body',
domainName: 'THE DOMAIN ENTERED FOR THE RECORD (FROM ADDRESS DOMAIN)',
keySelector: 'THE SELECTOR YOU ENTERED TO GENERATE THE RECORD',
privateKey: 'THE CONTENT FROM THE PRIVATE KEY BUT REPLACE linebreaks WITH \n'
};
`
Important: You must replace the linebreaks of the private key with \n` or it won't work.A use case for this, could be a multitenancy application. There the reply domains would be different, but you might want to send from the local SMTP server of the ISP. You would then make it possible for each tenant to configure the three values in their tenant settings within the application, and dynamically collect it prior to sending the mail.
Copyright (c) 2025
Licensed under the MIT license.