Email plugin for Hapi.js
Currently this plugin supports handlebars as the HTML template engine for the email body and Amazon Simple Email Service (SES) as the email engine, but it was designed in a way that more providers can be easily added if necessary.
Install hapi-mail by either running
npm install hapi-mail --save in your application's root directory or add 'hapi-mail' to the dependencies section of the 'package.json' file and run npm install.
How to use
This module assumes you are already familiar with Hapi.js and it's plugin conventions.
const options =template:engine: 'handlebars'path: './emails/'email:engine: 'ses'options: accessKeyId: processenvAWS_BACKEND_ID secretAccessKey: processenvAWS_BACKEND_SECRET region: 'us-east-1'defaultFrom: 'email@example.com';const email =from: 'firstname.lastname@example.org'to: 'email@example.com'cc: 'firstname.lastname@example.org'bcc: 'email@example.com'replyTo: 'firstname.lastname@example.org'returnPath: 'email@example.com'subject: 'Example registration confirmation'bodyTemplate: 'registration.html'bodyData: name: 'Paul Lang' username: 'paullang';server;// If you have a reference to the server, you can use thisserverplugins'hapi-mail';// If you have a reference to a request, you can use thisrequestserverplugins'hapi-mail';
hapi-mail PROTIPS: See test/plugin.js for working example, but you will need to set three environment variables for it to run: AWS_BACKEND_ID, AWS_BACKEND_SECRET, EMAIL
Since this module name has a - in the name, you cannot use dot notation to register and access it. e.g. server.plugins['hapi-mail'].sendMail(...) and cannot use server.plugins.hapi-mail.sendMail(...)
AWS PROTIP: Don't store your actual AWS key and secret in your source code and don't use your root AWS key and secret for your applications. Setup a limited access key using AWS IAM and either put them in environment variables or into a separate configuration file that won't get uploaded somewhere public like Github or NPM.