Merge pull request #3658 from processing/pr05/migrate_mail_system

pr05 Typescript Migration 12: Migrate server files related to emailing/nodemailer -- REBUILD

Author: raclim

package-lock.json

@@ -137,8 +137,11 @@
     "@testing-library/react": "^12.1.2",
     "@types/friendly-words": "^1.2.2",
     "@types/jest": "^29.5.14",
+    "@types/mjml": "^4.7.4",
     "@types/node": "^16.18.126",
+    "@types/nodemailer": "^7.0.1",
     "@types/passport": "^1.0.17",
+    "@types/nodemailer-mailgun-transport": "^1.4.6",
     "@types/react": "^16.14.0",
     "@types/react-dom": "^16.9.25",
     "@types/react-router-dom": "^5.3.3",

package.json

@@ -1,7 +1,7 @@
 import crypto from 'crypto';
 
 import User from '../models/user';
-import mail from '../utils/mail';
+import { mailerService } from '../utils/mail';
 import { renderEmailConfirmation, renderResetPassword } from '../views/mail';
 
 export * from './user.controller/apiKey';
@@ -83,7 +83,7 @@ export async function createUser(req, res) {
       });
 
       try {
-        await mail.send(mailOptions);
+        await mailerService.send(mailOptions);
         res.json(userResponse(user));
       } catch (mailErr) {
         console.error(mailErr);
@@ -155,7 +155,7 @@ export async function resetPasswordInitiate(req, res) {
       to: user.email
     });
 
-    await mail.send(mailOptions);
+    await mailerService.send(mailOptions);
     res.json({
       success: true,
       message:
@@ -203,7 +203,7 @@ export async function emailVerificationInitiate(req, res) {
       to: user.email
     });
     try {
-      await mail.send(mailOptions);
+      await mailerService.send(mailOptions);
     } catch (mailErr) {
       res.status(500).send({ error: 'Error sending mail' });
       return;
@@ -334,7 +334,7 @@ export async function updateSettings(req, res) {
         to: user.email
       });
 
-      await mail.send(mailOptions);
+      await mailerService.send(mailOptions);
     } else {
       await saveUser(res, user);
     }

server/controllers/user.controller.js

@@ -7,7 +7,7 @@ import {
   moveObjectToUserInS3,
   copyObjectInS3
 } from '../controllers/aws.controller';
-import mail from '../utils/mail';
+import { mailerService } from '../utils/mail';
 import { renderAccountConsolidation } from '../views/mail';
 
 const mongoConnectionString = process.env.MONGO_URL;
@@ -31,7 +31,8 @@ mongoose.connection.on('error', () => {
  * https://mongodb.github.io/node-mongodb-native
  */
 
-const agg = [ // eslint-disable-line
+const agg = [
+  // eslint-disable-line
   {
     $project: {
       email: {
@@ -187,7 +188,7 @@ async function consolidateAccount(email) {
       });
 
       return new Promise((resolve, reject) => {
-        mail.send(mailOptions, (mailErr, result) => {
+        mailerService.send(mailOptions, (mailErr, result) => {
           console.log('Sent email.');
           if (mailErr) {
             return reject(mailErr);
@@ -226,7 +227,7 @@ async function consolidateAccount(email) {
 //   });
 
 //   return new Promise((resolve, reject) => {
-//     mail.send(mailOptions, (mailErr, result) => {
+//     mailerService.send(mailOptions, (mailErr, result) => {
 //       console.log('Sent email.');
 //       if (mailErr) {
 //         return reject(mailErr);

server/migrations/emailConsolidation.js

@@ -0,0 +1,65 @@
+/** Rendered mail data for the mailer service, without the 'from' property, which will be automatically added */
+export interface RenderedMailerData {
+  to: string;
+  subject: string;
+  html?: string;
+}
+
+// -------- EMAIL OPTIONS --------
+/** Options to generate the account consolidation email */
+export interface AccountConsolidationEmailOptions {
+  body: {
+    domain: string;
+    username: string;
+    email: string;
+  };
+  to: string;
+}
+/** Options to generate the reset password email */
+export interface ResetPasswordEmailOptions {
+  body: {
+    domain: string;
+    link: string;
+  };
+  to: string;
+}
+/** Options to generate the confirm email email */
+export interface ConfirmEmailEmailOptions {
+  body: {
+    domain: string;
+    link: string;
+  };
+  to: string;
+}
+
+// -------- EMAIL RENDERING TEMPLATES --------
+/** Base template for emails */
+export interface BaseEmailTemplate {
+  domain: string;
+  headingText: string;
+  greetingText: string;
+  messageText: string;
+  directLinkText: string;
+  noteText: string;
+  meta: {
+    keywords: string;
+    description: string;
+  };
+}
+/** Template for an email with a primary button, which contains text and a link */
+export interface EmailWithPrimaryButtonTemplate extends BaseEmailTemplate {
+  link: string;
+  buttonText: string;
+}
+/** Template for rendering the account consolidation email */
+export interface AccountConsolidationEmailTemplate extends BaseEmailTemplate {
+  username: string;
+  email: string;
+  message2Text: string;
+  resetPasswordLink: string;
+  resetPasswordText: string;
+}
+/** Template for rendering the confirm email email */
+export type ConfirmEmailEmailTemplate = EmailWithPrimaryButtonTemplate;
+/** Template for rendering the reset password email */
+export type ResetPasswordEmailTemplate = EmailWithPrimaryButtonTemplate;

server/types/email.ts

@@ -0,0 +1 @@
+export * from './email';

server/types/index.ts

@@ -1,24 +1,30 @@
-/**
- * Mail service wrapping around mailgun
- */
-
 import nodemailer from 'nodemailer';
 import mg from 'nodemailer-mailgun-transport';
+import { RenderedMailerData } from '../types/email';
+
+if (!process.env.MAILGUN_KEY) {
+  throw new Error('Mailgun key missing');
+}
 
 const auth = {
   api_key: process.env.MAILGUN_KEY,
   domain: process.env.MAILGUN_DOMAIN
 };
 
+/** Mail service class wrapping around mailgun */
 class Mail {
+  client: nodemailer.Transporter;
+
+  sendOptions: Pick<nodemailer.SendMailOptions, 'from'>;
+
   constructor() {
     this.client = nodemailer.createTransport(mg({ auth }));
     this.sendOptions = {
       from: process.env.EMAIL_SENDER
     };
   }
 
-  async sendMail(mailOptions) {
+  async sendMail(mailOptions: nodemailer.SendMailOptions) {
     try {
       const response = await this.client.sendMail(mailOptions);
       return response;
@@ -28,8 +34,8 @@ class Mail {
     }
   }
 
-  async send(data) {
-    const mailOptions = {
+  async send(data: RenderedMailerData) {
+    const mailOptions: nodemailer.SendMailOptions = {
       from: this.sendOptions.from,
       to: data.to,
       subject: data.subject,
@@ -46,4 +52,7 @@ class Mail {
   }
 }
 
-export default new Mail();
+/**
+ * Mail service wrapping around mailgun
+ */
+export const mailerService = new Mail();

server/utils/mail.js renamed to server/utils/mail.ts

@@ -0,0 +1,14 @@
+/* eslint-disable consistent-return */
+import mjml2html from 'mjml';
+
+/** Parse template string containing mjml tags into html for nodemailer.SendMailOptions.html */
+export function renderMjml(template: string): string | undefined {
+  try {
+    const output = mjml2html(template);
+    return output.html;
+  } catch (e) {
+    console.error(e);
+    // fall through to undefined (null is not valid for nodemailer.SendMailOptions.html)
+    return undefined;
+  }
+}

server/utils/renderMjml.js

@@ -1,4 +1,7 @@
-export default ({
+import type { AccountConsolidationEmailTemplate } from '../types/email';
+
+/** Returns mjml for an Account Consolidation email */
+export const consolidationMailLayout = ({
   domain,
   headingText,
   greetingText,
@@ -11,7 +14,7 @@ export default ({
   resetPasswordText,
   noteText,
   meta
-}) =>
+}: AccountConsolidationEmailTemplate) =>
   `
 <mjml>
   <mj-head>