wmail

v0.11.2

Published

3 years ago

Mailgun email client with support for templates and layouts

Downloads

0High
0Medium
0Low

eldoy

Wmail

Send emails with Mailgun. Boasts the following features:

Send email with Mailgun
Layout support
Supports HTML, Markdown and Mustache templates
Automatically converts HTML to use as text version

Made for the Waveorb web app development platform.

Installation

npm i wmail

Templates

In app/layouts add a file called mail.js:

module.exports = async function(mail, $, data) {
  return /* html */`
    <!doctype html>
    <html lang="en">
      <head>
        <meta http-equiv="content-type" content="text/html; charset=utf-8">
        <title>${mail.subject || 'Wmail'}</title>
        <style>
          body { background-color: gold; }
        </style>
      </head>
      <body>
        <div class="content">${mail.content}</div>
        <div>Best regards</div>
      </body>
    </html>
  `
}

Then in your app/mail directory add a file called mail1.js (or whatever):

module.exports = async function($, data) {
  return {
    layout: 'mail',
    subject: 'mail1',
    content: `mail1 html content link ${data.key}`
  }
}

The email content can be written in Markdown:

// ...
format: 'markdown',
content: `# Hello`
// ...

The layout can't do Markdown, it has to be HTML.

You can use the file option to set the content from a file:

module.exports = async function($, data) {
  return {
    layout: 'mail',
    subject: 'mail1',
    file: 'data/markdown/mail.md'
  }
}

The markdown will be automatically transformed to HTML if it's a markdown file.

Variables

You can pass variables through the data parameter:

await mailer.send('mail1', $, options, data)
// ...
content: `mail1 html content link ${data.key}`
// ...

You can also use Mustache:

// ...
content: `mail1 html content link {{data.key}}`
// ...

Both of these techniques work in the layout as well.

Configuration

In app/config add a file called mail.yml:

domain: example.com
key: mailgun-api-key
options:
  reply: [email protected]
  from: [email protected]
  to: [email protected]

Create a plugin in app/plugins called mailer.js:

const mailer = require('wmail')

module.exports = async function(app) {
  app.mailer = mailer(app.config.mail)
}

Send email

Emails will automatically include the text version which is converted from the HTML in your templates.

// Use mailer from plugin
const mailer = $.app.mailer

// Send email
const options = {
  to: 'Vidar Eldøy <[email protected]>',
  attachment: [file]
}

// All possible options:
{
  to: '[email protected]',
  from: '[email protected]',
  cc: '[email protected]',
  bcc: '[email protected]',
  subject: 'hello',
  html: '<h1>Hello</h1>',
  text: 'Hello',
  reply: '[email protected]',
  attachment: [readStream],
  inline: [readStream]
}

// Parameters: name, $, options, data
const data = { key: 'hello' }
const result = await mailer.send('mail1', $, options, data)

// On success
{
  id: '<[email protected]>',
  message: 'Queued. Thank you.'
}

// On error
{
  "id": undefined,
  "message": "'from' parameter is missing",
  "status": 400
}

MIT licensed. Enjoy!

Published

Vulnerabilities

Links

Maintainers

Keywords