feat(contact-us): add contact form submission

add complete contact-us module including controller, validated DTO and service
add SUPPORT_EMAIL to .env.example
register ContactUsModule in root app module
implement form submission that sends team notifications and user confirmation emails

.env.example

@@ -20,4 +20,5 @@ SMTP_PORT=587
 SMTP_USER=your-email@gmail.com
 SMTP_PASS=your-app-password
 SMTP_FROM=MaternAlert <no-reply@maternalert.com>
+SUPPORT_EMAIL=support@maternalert.com.ng
 

src/app.module.ts

@@ -14,6 +14,7 @@ import { EducationModule } from "./education/education.module";
 import { ClinicFinderModule } from "./clinic-finder/clinic-finder.module";
 import { MonitoringEngineModule } from "./monitoring-engine/monitoring-engine.module";
 import { EmailModule } from "./email/email.module";
+import { ContactUsModule } from "./contact-us/contact-us.module";
 import { AppController } from "./app.controller";
 import { HealthController } from "./health.controller";
 
@@ -50,6 +51,7 @@ import { HealthController } from "./health.controller";
     ClinicFinderModule,
     MonitoringEngineModule,
     EmailModule,
+    ContactUsModule,
   ],
   controllers: [AppController, HealthController],
   providers: [

src/contact-us/contact-us.controller.ts

@@ -0,0 +1,14 @@
+import { Controller, Post, Body, HttpCode, HttpStatus } from "@nestjs/common";
+import { ContactUsService } from "./contact-us.service";
+import { CreateContactUsDto } from "./dto/create-contact-us.dto";
+
+@Controller("contact-us")
+export class ContactUsController {
+  constructor(private readonly contactUsService: ContactUsService) {}
+
+  @Post()
+  @HttpCode(HttpStatus.OK)
+  async submit(@Body() createContactUsDto: CreateContactUsDto) {
+    return this.contactUsService.submitContactForm(createContactUsDto);
+  }
+}

src/contact-us/contact-us.module.ts

@@ -0,0 +1,11 @@
+import { Module } from "@nestjs/common";
+import { ContactUsController } from "./contact-us.controller";
+import { ContactUsService } from "./contact-us.service";
+import { EmailModule } from "../email/email.module";
+
+@Module({
+  imports: [EmailModule],
+  controllers: [ContactUsController],
+  providers: [ContactUsService],
+})
+export class ContactUsModule {}

src/contact-us/contact-us.service.ts

@@ -0,0 +1,52 @@
+import { Injectable, Logger } from "@nestjs/common";
+import { ConfigService } from "@nestjs/config";
+import { CreateContactUsDto } from "./dto/create-contact-us.dto";
+import { EmailService } from "../email/email.service";
+
+@Injectable()
+export class ContactUsService {
+  private readonly logger = new Logger(ContactUsService.name);
+
+  constructor(
+    private readonly emailService: EmailService,
+    private readonly configService: ConfigService,
+  ) {}
+
+  async submitContactForm(createContactUsDto: CreateContactUsDto) {
+    this.logger.log(`Contact form submitted by: ${createContactUsDto.email}`);
+
+    const supportEmail =
+      this.configService.get<string>("SUPPORT_EMAIL") ||
+      "support@maternalert.com.ng";
+
+    // Send notification to MaternAlert team
+    await this.emailService.sendEmail(
+      supportEmail,
+      `New Contact Form: ${createContactUsDto.subject}`,
+      `
+Name: ${createContactUsDto.name}
+Email: ${createContactUsDto.email}
+Subject: ${createContactUsDto.subject}
+
+Message:
+${createContactUsDto.message}
+      `,
+    );
+
+    // Send confirmation to the user
+    await this.emailService.sendEmail(
+      createContactUsDto.email,
+      "Thank you for contacting MaternAlert",
+      `
+Hello ${createContactUsDto.name},
+
+Thank you for reaching out to MaternAlert. We have received your message and will respond as soon as possible.
+
+Best regards,
+The MaternAlert Team
+      `,
+    );
+
+    return { message: "Contact form submitted successfully" };
+  }
+}

src/contact-us/dto/create-contact-us.dto.ts

@@ -0,0 +1,36 @@
+import { IsEmail, IsNotEmpty, IsString, MaxLength } from "class-validator";
+
+/**
+ * Create Contact Us DTO
+ *
+ * VALIDATION RULES:
+ * - Name: max 100 characters
+ * - Email: valid email format
+ * - Subject: max 200 characters
+ * - Message: max 2000 characters
+ *
+ * CLINICAL SAFETY:
+ * - No medical data collected
+ * - No diagnostic information
+ * - Plain text communication only
+ */
+export class CreateContactUsDto {
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(100)
+  name!: string;
+
+  @IsEmail()
+  @IsNotEmpty()
+  email!: string;
+
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(200)
+  subject!: string;
+
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(2000)
+  message!: string;
+}