// # Mail API // API for sending Mail var _ = require('lodash'), Promise = require('bluebird'), config = require('../config'), canThis = require('../permissions').canThis, errors = require('../errors'), mailer = require('../mail'), Models = require('../models'), path = require('path'), fs = require('fs'), templatesDir = path.resolve(__dirname, '..', 'email-templates'), htmlToText = require('html-to-text'), mail; /** * ## Mail API Methods * * **See:** [API Methods](index.js.html#api%20methods) * @typedef Mail * @param mail */ mail = { /** * ### Send * Send an email * * @public * @param {Mail} object details of the email to send * @returns {Promise} */ send: function (object, options) { return canThis(options.context).send.mail().then(function () { return mailer.send(object.mail[0].message) .then(function (data) { delete object.mail[0].options; // Sendmail returns extra details we don't need and that don't convert to JSON delete object.mail[0].message.transport; object.mail[0].status = { message: data.message }; return object; }) .catch(function (error) { return Promise.reject(new errors.EmailError(error.message)); }); }, function () { return Promise.reject(new errors.NoPermissionError('You do not have permission to send mail.')); }); }, /** * ### SendTest * Send a test email * * @public * @param {Object} options required property 'to' which contains the recipient address * @returns {Promise} */ sendTest: function (options) { return Models.User.findOne({id: options.context.user}).then(function (result) { return mail.generateContent({template: 'test'}).then(function (emailContent) { var payload = {mail: [{ message: { to: result.get('email'), subject: 'Test Ghost Email', html: emailContent.html, text: emailContent.text } }]}; return mail.send(payload, options); }); }, function () { return Promise.reject(new errors.NotFoundError('Could not find the current user')); }); }, /** * * @param {Object} options { * data: JSON object representing the data that will go into the email * template: which email template to load (files are stored in /core/server/email-templates/) * } * @returns {*} */ generateContent: function (options) { var defaultData = { siteUrl: config.forceAdminSSL ? (config.urlSSL || config.url) : config.url }, emailData = _.defaults(defaultData, options.data); _.templateSettings.interpolate = /{{([\s\S]+?)}}/g; // read the proper email body template return new Promise(function (resolve, reject) { fs.readFile(templatesDir + '/' + options.template + '.html', {encoding: 'utf8'}, function (err, fileContent) { if (err) { reject(err); } // insert user-specific data into the email var htmlContent = _.template(fileContent, emailData), textContent; // generate a plain-text version of the same email textContent = htmlToText.fromString(htmlContent); resolve({ html: htmlContent, text: textContent }); }); }); } }; module.exports = mail;