Add email functionality with Nodemailer and update README for SMTP configuration

- Added Nodemailer as a dependency for email sending capabilities.
- Created a new email module to handle email sending and SMTP configuration verification.
- Updated README to include environment variable setup for email configuration, including SMTP details and Gmail setup instructions.

Author: aahnik

Diff for: README.md

@@ -225,4 +225,47 @@ Add JSDoc comments with Swagger annotations to your API routes:
  *       200:
  *         description: Success response
  */
+```
+
+### Environment Variables
+
+Make sure your `.env` file includes:
+
+```env
+DATABASE_URL=postgres://postgres:postgres@localhost:5432/mint
+
+# Email Configuration
+SMTP_HOST=smtp.example.com
+SMTP_PORT=587
+SMTP_SECURE=false
+SMTP_USER=your-email@example.com
+SMTP_PASSWORD=your-smtp-password
+SMTP_FROM_NAME=Mint Platform
+SMTP_FROM_EMAIL=noreply@example.com
+```
+
+#### Email Configuration Details
+
+- `SMTP_HOST`: Your SMTP server hostname (e.g., smtp.gmail.com for Gmail)
+- `SMTP_PORT`: SMTP port (usually 587 for TLS or 465 for SSL)
+- `SMTP_SECURE`: Use `true` for port 465, `false` for other ports
+- `SMTP_USER`: Your SMTP username/email
+- `SMTP_PASSWORD`: Your SMTP password or app-specific password
+- `SMTP_FROM_NAME`: Display name for sent emails
+- `SMTP_FROM_EMAIL`: Email address used as sender
+
+#### Gmail Setup
+
+If using Gmail:
+1. Enable 2-factor authentication
+2. Generate an app password
+3. Use the app password as `SMTP_PASSWORD`
+
+Example Gmail configuration:
+```env
+SMTP_HOST=smtp.gmail.com
+SMTP_PORT=587
+SMTP_SECURE=false
+SMTP_USER=your-gmail@gmail.com
+SMTP_PASSWORD=your-app-specific-password
 ```

Diff for: lib/email.ts

@@ -0,0 +1,49 @@
+import nodemailer from "nodemailer";
+
+type EmailOptions = {
+  to: string;
+  subject: string;
+  text?: string;
+  html?: string;
+};
+
+// Create reusable transporter
+const transporter = nodemailer.createTransport({
+  host: process.env.SMTP_HOST,
+  port: parseInt(process.env.SMTP_PORT || "587"),
+  secure: process.env.SMTP_SECURE === "true",
+  auth: {
+    user: process.env.SMTP_USER,
+    pass: process.env.SMTP_PASSWORD,
+  },
+});
+
+export async function sendEmail({ to, subject, text, html }: EmailOptions) {
+  try {
+    const info = await transporter.sendMail({
+      from: `"${process.env.SMTP_FROM_NAME}" <${process.env.SMTP_FROM_EMAIL}>`,
+      to,
+      subject,
+      text,
+      html,
+    });
+
+    console.log("Email sent:", info.messageId);
+    return info;
+  } catch (error) {
+    console.error("Error sending email:", error);
+    throw error;
+  }
+}
+
+// Verify SMTP connection
+export async function verifyEmailConfig() {
+  try {
+    await transporter.verify();
+    console.log("SMTP connection verified successfully");
+    return true;
+  } catch (error) {
+    console.error("SMTP verification failed:", error);
+    return false;
+  }
+}

Diff for: package.json

@@ -66,6 +66,7 @@
     "marked": "^15.0.6",
     "next": "14.2.13",
     "next-swagger-doc": "^0.4.1",
+    "nodemailer": "^6.10.0",
     "oslo": "^1.2.1",
     "pg": "^8.13.1",
     "prom-client": "^15.1.0",