Merge pull request #106 from Upstra/feat/mail

Feat: implement zoho mail

Author: jabibamman

.env.prod.example

@@ -55,3 +55,10 @@ SWAGGER_VERSION=0.8.8
 # Variables Grafana
 GRAFANA_ADMIN_USER=admin
 GRAFANA_ADMIN_PASSWORD=admin
+
+MAIL_HOST=
+MAIL_PORT=
+MAIL_USER=
+MAIL_PASS=
+MAIL_SECURE=
+MAIL_FROM=

README.md

@@ -95,7 +95,7 @@ BACKEND_URL=http://localhost:3002
 RATE_LIMIT_GLOBAL_WINDOW_MS=900000    # 15 minutes
 RATE_LIMIT_GLOBAL_MAX=1000            # 1000 requests per window
 
-RATE_LIMIT_AUTH_WINDOW_MS=900000      # 15 minutes  
+RATE_LIMIT_AUTH_WINDOW_MS=900000      # 15 minutes
 RATE_LIMIT_AUTH_STRICT_MAX=5          # Login/register: 5 attempts
 RATE_LIMIT_AUTH_MODERATE_MAX=10       # 2FA: 10 attempts
 
@@ -140,6 +140,26 @@ Puis l’API est dispo sur `http://localhost:3000`
 La doc Swagger est dispo sur `http://localhost:3000/docs`
 Le JSON du schéma est disponible sur `http://localhost:3000/docs-json`
 
+### Email Transactionnel
+
+**Dossier** : src/modules/email
+
+**Templates** : src/modules/email/infrastructure/templates/\*.hbs
+
+**Use-Cases** :
+
+```
+SendAccountCreatedEmailUseCase
+
+SendResetPasswordEmailUseCase
+
+SendPasswordChangedEmailUseCase
+```
+
+**Configuration** : variables d’environnement listées ci-dessus.
+
+Pour créer un nouveau template, ajoutez un xxx.hbs et un SendXxxEmailUseCase.
+
 ### 📊 Monitoring avec Prometheus et Grafana
 
 L'application expose des métriques Prometheus sur `/metrics`:
@@ -149,19 +169,21 @@ L'application expose des métriques Prometheus sur `/metrics`:
   - Login: admin / Password: admin
 
 Les métriques incluent:
+
 - Utilisation CPU et mémoire
 - Event loop lag
 - Handles et requêtes actives
 - Statistiques de garbage collection
 
 Pour ajouter des métriques personnalisées dans votre code:
+
 ```typescript
 import { Counter, Histogram } from 'prom-client';
 
 const httpRequestDuration = new Histogram({
   name: 'infra_control_http_request_duration_seconds',
   help: 'Duration of HTTP requests in seconds',
-  labelNames: ['method', 'route', 'status']
+  labelNames: ['method', 'route', 'status'],
 });
 ```
 
@@ -280,11 +302,13 @@ Ces commandes utilisent `-r dotenv/config` pour charger automatiquement les vari
 L'application intègre un système de sécurité multi-niveau :
 
 ### 🛡️ Protection des Headers (Helmet)
+
 - Content Security Policy (CSP)
 - Protection XSS et clickjacking
 - Headers de sécurité automatiques
 
 ### ⚡ Rate Limiting Intelligent
+
 - **Rate limiting global** : Protection DDoS générale
 - **Rate limiting auth** : Limitation des tentatives de connexion/2FA
 - **Rate limiting sensitif** : Protection des opérations critiques (rôles, permissions)
@@ -295,6 +319,7 @@ L'application intègre un système de sécurité multi-niveau :
 ### Configuration des limites par environnement
 
 Les variables peuvent être ajustées selon l'environnement :
+
 - **Développement** : Limites permissives pour faciliter les tests
 - **Production** : Limites strictes pour la sécurité
 

infra

@@ -2,6 +2,14 @@
 
 set -e
 
+# Couleurs pour l'affichage
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Fichiers et répertoires
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 source "$SCRIPT_DIR/scripts/config.sh"

jest.email.config.js

@@ -0,0 +1,26 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  moduleNameMapper: {
+    '^@/(.*)$': '<rootDir>/$1',
+    '^@core/(.*)$': '<rootDir>/core/$1',
+    '^@modules/(.*)$': '<rootDir>/modules/$1'
+  },
+  rootDir: 'src',
+  testMatch: ['<rootDir>/modules/email/**/*.spec.ts'],
+  collectCoverageFrom: [
+    'modules/email/**/*.ts',
+    '!modules/email/**/*.spec.ts',
+    '!modules/email/**/*.module.ts',
+    '!modules/email/**/index.ts',
+  ],
+  coverageThreshold: {
+    global: {
+      branches: 90,
+      functions: 90,
+      lines: 90,
+      statements: 90,
+    },
+  },
+  coverageDirectory: '../coverage/email',
+};

nest-cli.json

@@ -6,7 +6,17 @@
     "deleteOutDir": true,
     "webpack": false,
     "webpackConfigPath": "webpack.config.js",
-    "tsConfigPath": "tsconfig.json"
+    "tsConfigPath": "tsconfig.json",
+    "assets": [
+      {
+        "include": "**/*.hbs",
+        "watchAssets": true
+      },
+      {
+        "include": "**/assets/**/*",
+        "watchAssets": true
+      }
+    ]
   },
   "watchIgnore": [
     "**/node_modules/**",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "infra-control",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "description": "",
   "author": "",
   "private": true,
@@ -28,9 +28,11 @@
   },
   "dependencies": {
     "@liaoliaots/nestjs-redis": "^10.0.0",
+    "@nestjs-modules/mailer": "^2.0.2",
     "@nestjs/common": "^11.0.13",
     "@nestjs/config": "^4.0.2",
     "@nestjs/core": "^11.0.13",
+    "@nestjs/event-emitter": "^3.0.1",
     "@nestjs/jwt": "^11.0.0",
     "@nestjs/passport": "^11.0.5",
     "@nestjs/platform-express": "^11.0.13",
@@ -46,8 +48,11 @@
     "cookie-parser": "^1.4.7",
     "express": "^5.1.0",
     "express-rate-limit": "^7.5.1",
+    "handlebars": "^4.7.8",
     "helmet": "^8.1.0",
     "ioredis": "^5.6.1",
+    "nodemailer": "^7.0.4",
+    "nodemailer-express-handlebars": "^7.0.0",
     "passport": "^0.7.0",
     "passport-jwt": "^4.0.1",
     "pg": "^8.14.1",