SendGrid email utility

emailUtility.js

const sgMail = require('@sendgrid/mail');

sgMail.setTimeout(40000);

const TAG = 'emailUtility';
const DEFAULT_SENDER = '[email protected]';

/**
 * Send an email.
 *
 * @param {object} toSend The email envelope object to send.
 * @param {string} apiKey The email API key.
 * @return {Promise} A promise.
 */
exports.send = (toSend, apiKey) =>
    new Promise((resolve, reject) => {
        console.log(`${TAG}::Attempting to send:`, JSON.stringify(toSend, null, 2));
        sgMail.setApiKey(apiKey);
        sgMail
            .send(toSend)
            .then((response) => {
                console.log(`${TAG}::Successful email send response:`, response);
                resolve(response);
            })
            .catch((error) => {
                console.error(`${TAG}::Failed to send an email.`, JSON.stringify(error, null, 2));
                reject(error);
            });
    });

/**
 * Compose a notification email envelope for sending.
 *
 * @param {string} subject The subject of the email.
 * @param {string} content The content of the email.
 * @param {string} recipient The recipient email address.
 * @param {string} sender The sender email address. If null, this will default to the configured default value.
 * @return {object} The email object.
 */
exports.composeEmail = (subject, content, recipient, sender) => {
    let sendFrom = sender;
    if (!sender) {
        sendFrom = process.env.EMAIL_FROM || DEFAULT_SENDER;
    }

    // Return the email envelope object.
    return {
        to: recipient,
        from: sendFrom,
        subject,
        text: 'Plain text is not supported. Please use an email client that is capable of rendering HTML.',
        html: content,
    };
};