feat(mailer): add ejs template handling

src/app.module.ts

@@ -4,6 +4,7 @@ import { AppController } from './app.controller';
 import { StructuresModule } from './structures/structures.module';
 import { ConfigurationModule } from './configuration/configuration.module';
 import { CategoriesModule } from './categories/categories.module';
+import { MailerModule } from './mailer/mailer.module';
 @Module({
   imports: [
     ConfigurationModule,
@@ -12,6 +13,7 @@ import { CategoriesModule } from './categories/categories.module';
     ),
     StructuresModule,
     CategoriesModule,
+    MailerModule,
   ],
   controllers: [AppController],
 })

src/configuration/config.ts

+export const config = {
+  url: process.env.MAIL_URL,
+  token: process.env.MAIL_TOKEN,
+  host: 'ram.grandlyon.com',
+  protocol: 'https',
+  port: '443',
+  from: 'inclusionnumerique@grandlyon.com',
+  from_name: 'Réseau des acteurs de la médiation numérique',
+  replyTo: 'inclusionnumerique@grandlyon.com',
+  templates: {
+    directory: './src/mailer/mail-templates',
+    verify: {
+      ejs: 'verify.ejs',
+      json: 'verify.json',
+    },
+    changeEmail: {
+      ejs: 'changeEmail.ejs',
+      json: 'changeEmail.json',
+    },
+  },
+};

src/configuration/configuration.service.ts

 import * as dotenv from 'dotenv';
-
+import { config } from './config';
 export class ConfigurationService {
+  private _config = config;
+
   constructor() {
     // Initializing conf with values from var env
     dotenv.config();
   }
+
+  get config() {
+    return this._config;
+  }
 }

src/mailer/mail-templates/changeEmail.ejs

+Bonjour,<br />
+<br />
+Votre adresse email a été modifiée, si vous en avez bien fait la demande,
+<a href="<%= config.protocol %>://<%= config.host %><%= config.port ? ':' + config.port : '' %>/change-email/<%= token %>"
+  >cliquez ici pour valider le changement.</a
+>
+<br />
+Ce mail est un mail automatique. Merci de ne pas y répondre.

src/mailer/mail-templates/changeEmail.json

+{
+  "subject": "Changement d'adresse email"
+}

src/mailer/mail-templates/verify.ejs

+Bonjour<br />
+<br />
+Afin de pouvoir vous connecter sur la plateforme, merci de cliquer sur
+<a
+  href="<%= config.protocol %>://<%= config.host %><%= config.port ? ':' + config.port : '' %>/users/verify/<%= token %>"
+  >ce lien</a
+>
+afin de valider votre inscription<br />
+<br />
+Ce mail est un mail automatique. Merci de ne pas y répondre.

src/mailer/mail-templates/verify.json

+{
+  "subject": "Bienvenue sur le Réseau des Acteurs de la Médiation Numérique de la Métropole de Lyon"
+}

src/mailer/mailer.module.ts

+import { Module } from '@nestjs/common';
+import { HttpModule } from '@nestjs/common/http/http.module';
+import { MailerService } from './mailer.service';
+
+@Module({
+  imports: [HttpModule],
+  providers: [MailerService],
+  exports: [MailerService],
+})
+export class MailerModule {}

src/mailer/mailer.service.spec.ts

+import { Test, TestingModule } from '@nestjs/testing';
+import { MailerService } from './mailer.service';
+
+describe('MailerService', () => {
+  let service: MailerService;
+
+  beforeEach(async () => {
+    const module: TestingModule = await Test.createTestingModule({
+      providers: [MailerService],
+    }).compile();
+
+    service = module.get<MailerService>(MailerService);
+  });
+
+  it('should be defined', () => {
+    expect(service).toBeDefined();
+  });
+});

src/mailer/mailer.service.ts

+import { HttpService, Injectable, Logger } from '@nestjs/common';
+import { ConfigurationService } from '../configuration/configuration.service';
+import * as fs from 'fs';
+import * as path from 'path';
+@Injectable()
+export class MailerService {
+  public config = null;
+  constructor(private readonly httpService: HttpService, private configurationService: ConfigurationService) {
+    this.config = this.configurationService.config;
+  }
+
+  /**
+   * Send an email
+   *
+   * @param {string} from
+   * @param {string} to
+   * @param {string} replyTo
+   * @param {string} subject
+   * @param {string} html
+   * @param {string} text
+   */
+  public send(to: string, subject: string, html: string): Promise<any> {
+    const data = JSON.stringify({
+      from: this.config.from,
+      // eslint-disable-next-line camelcase
+      from_name: this.config.from_name,
+      to: to,
+      subject: subject,
+      content: html,
+    });
+    Logger.log(`[Mailer] Send mail : ${subject}`);
+    return new Promise((resolve, reject) => {
+      this.httpService
+        .post(process.env.MAIL_URL, data, {
+          headers: {
+            'Content-Type': 'application/json',
+            Authorization: 'Bearer ' + process.env.MAIL_TOKEN,
+          },
+        })
+        .subscribe(
+          (body) => {
+            Logger.log(`[Mailer] Send mail : ${subject} success`);
+            return resolve(body);
+          },
+          (err) => {
+            Logger.error(err);
+            return reject(err);
+          }
+        );
+    });
+  }
+
+  /**
+   * Get email template location from config directory and given filename. Also, check if file exists.
+   *
+   * @param {string} filename
+   */
+  public getTemplateLocation(filename) {
+    const ejsPath = path.join(this.config.templates.directory, filename);
+    if (!fs.existsSync(ejsPath)) {
+      throw new Error(`Email template '${filename}' cannot be found in ${this.config.templates.directory}`);
+    }
+    return ejsPath;
+  }
+  /**
+   * Load email json config file from config directory and given filename. Also, check if file exists
+   *
+   * @param {filename} filename
+   */
+  public loadJsonConfig(filename) {
+    const jsonPath = path.join(this.config.templates.directory, filename);
+    if (!fs.existsSync(jsonPath)) {
+      throw new Error(`Email json definition file '${filename}' cannot be found in ${this.config.templates.directory}`);
+    }
+    return JSON.parse(fs.readFileSync(jsonPath).toString());
+  }
+}

src/structures/structures.module.ts

 import { HttpModule, Module } from '@nestjs/common';
 import { MongooseModule } from '@nestjs/mongoose';
+import { MailerModule } from '../mailer/mailer.module';
 import { Structure, StructureSchema } from './schemas/structure.schema';
 import { StructuresController } from './structures.controller';
 import { StructuresService } from './structures.service';
 
 @Module({
-  imports: [MongooseModule.forFeature([{ name: Structure.name, schema: StructureSchema }]), HttpModule],
+  imports: [MongooseModule.forFeature([{ name: Structure.name, schema: StructureSchema }]), HttpModule, MailerModule],
   controllers: [StructuresController],
   providers: [StructuresService],
 })

template.env

@@ -9,3 +9,5 @@ MONGO_DB_HOST_AND_PORT=<host:port used by the api to connect to mongo db>
 ME_CONFIG_BASICAUTH_USERNAME=<mongo express username>
 ME_CONFIG_BASICAUTH_PASSWORD=<mongo express password>
 ME_PORT=<mongo express port>
+MAIL_URL=<API url>
+MAIL_TOKEN=<API token>
\ No newline at end of file