This package has been deprecated

Author message:

hof-emailer has been added directly into hof v19.0.1 <(^_^)> and should not be installed separately

hof-emailer

2.1.1 • Public • Published

HOF Emailer

An emailer service for HOF applications.

Installation

$ npm install hof-emailer --save

Usage

// first create an emailer instance
const Emailer = require('hof-emailer');
const emailer = new Emailer({
  from: 'sender@example.com',
  transport: 'smtp',
  transportOptions: {
    host: 'my.smtp.host',
    port: 25
  }
});

// then you can use your emailer to send emails
const to = 'recipient@example.com';
const body = 'This is the email body';
const subject = 'Important email!'
emailer.send(to, body, subject)
  .then(() => {
    console.log(`Email sent to ${to}!`);
  });

Options

  • from: : Address to send emails from. Required.
  • transport: : Select what mechanism to use to send emails. Defaults: 'smtp'.
  • transportOptions: : Set the options for the chosen transport, as defined below. Required.
  • layout: : Optional path to use a custom layout for email content.

Transports

The following transport options are available:

smtp

nodemailer-smtp-transport

Options

  • host : Address of the mailserver. Required.
  • port <String|Number>: Port of the mailserver. Required.
  • ignoreTLS : Defaults to false.
  • secure : Defaults to true.
  • auth.user : Mailserver authorisation username.
  • auth.pass : Mailserver authorisation password.

ses

nodemailer-ses-transport

Options

  • accessKeyId : AWS accessKeyId. Required.
  • secretAccessKey : AWS accessKeyId. Required.
  • sessionToken
  • region . Defaults to 'eu-west-1'.
  • httpOptions
  • rateLimit
  • maxConnections

debug

A development option to write the html content of the email to a file for inspection.

transport: 'debug'

debug options

  • dir : The location to save html to. Default: ./.emails. This directory will be created if it does not exist.
  • open : If set to true, will automatically open the created html file in a browser.

debug example

transport: 'debug'
transportOptions: {
  dir: './emails',
  open: true
}

stub

Disables sending email. No options are required.

Readme

Keywords

none

Package Sidebar

Install

npm i hof-emailer

Weekly Downloads

1

Version

2.1.1

License

MIT

Unpacked Size

47.6 kB

Total Files

35

Last publish

Collaborators

  • dk4g
  • jamiecarterho
  • mylrajan
  • william-gu-hof
  • temitopeayoku
  • mdev246
  • vinodha.s
  • chisomoguibe
  • robertmccann
  • rhyad-zergane-ho
  • rhodine
  • mohameduwais
  • lennym
  • easternbloc
  • joefitter
  • coupey
  • sulthan-ahmed
  • andrew.moody.ho
  • aswann
  • robertdeniszczyc2
  • agraham19
  • aaron.robinson
  • sarahjaneluff
  • cmedland
  • hof-bot-user
  • josephchapman