[SSF-159] - Automated Emails 1 Implementation

.github/workflows/backend-tests.yml

@@ -33,6 +33,7 @@ jobs:
       DATABASE_NAME_TEST: securing-safe-food-test
       DATABASE_USERNAME: postgres
       DATABASE_PASSWORD: postgres
+      SEND_AUTOMATED_EMAILS: 'true'
       NX_DAEMON: 'false'
       CYPRESS_INSTALL_BINARY: '0'
     steps:

apps/backend/src/emails/awsSes.wrapper.ts

@@ -57,6 +57,9 @@ export class AmazonSESWrapper {
     const messageData = await new MailComposer(mailOptions).compile().build();
 
     const command = new SendEmailCommand({
+      Destination: {
+        ToAddresses: recipientEmails,
+      },
       Content: {
         Raw: {
           Data: messageData,

apps/backend/src/emails/email.service.ts

@@ -21,7 +21,7 @@ export class EmailsService {
    * @param recipientEmail the email address of the recipients
    * @param subject the subject of the email
    * @param bodyHtml the HTML body of the email
-   * @param attachments any base64 encoded attachments to inlude in the email
+   * @param attachments any base64 encoded attachments to include in the email
    * @resolves if the email was sent successfully
    * @rejects if the email was not sent successfully
    */
@@ -31,11 +31,19 @@ export class EmailsService {
     bodyHTML: string,
     attachments?: EmailAttachment[],
   ): Promise<unknown> {
-    return this.amazonSESWrapper.sendEmails(
-      recipientEmails,
-      subject,
-      bodyHTML,
-      attachments,
-    );
+    if (
+      process.env.SEND_AUTOMATED_EMAILS &&
+      process.env.SEND_AUTOMATED_EMAILS === 'true' &&
+      recipientEmails.length > 0
+    ) {
+      return this.amazonSESWrapper.sendEmails(
+        recipientEmails,
+        subject,
+        bodyHTML,
+        attachments,
+      );
+    }
+    this.logger.warn('Automated emails are disabled. Email not sent.');
+    return Promise.resolve();
   }
 }

apps/backend/src/emails/emailTemplates.ts

@@ -0,0 +1,101 @@
+export type EmailTemplate = {
+  subject: string;
+  bodyHTML: string;
+  additionalContent?: string;
+};
+
+export const EMAIL_REDIRECT_URL = 'localhost:4200';
+// TODO: Change this before production to be the actual ssf email
+export const SSF_PARTNER_EMAIL = 'example@gmail.com';
+
+export const emailTemplates = {
+  pantryFmApplicationApproved: (params: { name: string }): EmailTemplate => ({
+    subject: 'Your Securing Safe Food Account Has Been Approved',
+    bodyHTML: `
+      <p>Hi ${params.name},</p>
+      <p>
+        We're excited to let you know that your Securing Safe Food account has been
+        approved and is now active. You can now log in using the credentials created
+        during registration to begin submitting requests, managing donations, and
+        coordinating with our network.
+      </p>
+      <p>
+        If you have any questions as you get started or need help navigating the
+        platform, please do not hesitate to reach out — we are happy to help!
+      </p>
+      <p>
+        We are grateful to have you as part of the SSF community and look forward
+        to working together to expand access to allergen-safe food.
+      </p>
+      <p>Best regards,<br />The Securing Safe Food Team</p>
+    `,
+  }),
+
+  volunteerAccountCreated: (): EmailTemplate => ({
+    subject: 'Welcome to Securing Safe Food: Your Volunteer Account Is Ready',
+    bodyHTML: `
+      <p>Welcome to Securing Safe Food!</p>
+      <p>
+        Your volunteer account has been successfully created and you can now log in
+        to begin supporting pantry coordination, order matching, and delivery logistics.
+      </p>
+      <p>
+        Once logged in, you'll be able to view your assignments, track active requests,
+        and collaborate with partner organizations.
+      </p>
+      <p>
+        Thank you for being part of our mission. Your time and effort directly help
+        increase access to safe food for individuals with dietary restrictions.
+      </p>
+      <p>Best regards,<br />The Securing Safe Food Team</p>
+      <p>
+        To log in to your account, please click the following link: <a href="${EMAIL_REDIRECT_URL}/login">${EMAIL_REDIRECT_URL}/login</a>
+      </p>
+    `,
+  }),
+
+  pantryFmApplicationSubmittedToAdmin: (): EmailTemplate => ({
+    subject: 'New Partner Application Submitted',
+    bodyHTML: `
+      <p>Hi,</p>
+      <p>
+        A new partner application has been submitted through the SSF platform. 
+        Please log in to the dashboard to review and take action. 
+      </p>
+      <p>Best regards,<br />The Securing Safe Food Team</p>
+      <p>
+        To review this application, please enter the admin pantry approval dashboard: <a href="${EMAIL_REDIRECT_URL}/approve-pantries">${EMAIL_REDIRECT_URL}/approve-pantries</a>
+      </p>
+    `,
+  }),
+
+  pantryFmApplicationSubmittedToUser: (params: {
+    name: string;
+  }): EmailTemplate => ({
+    subject: 'Your Application Has Been Submitted',
+    bodyHTML: `
+      <p>Hi ${params.name},</p>
+      <p>
+        Thank you for your interest in partnering with Securing Safe Food! 
+        Your application has been successfully submitted and is currently under review. We will notify you via email once a decision has been made.
+      </p>
+      <p>Best regards,<br />The Securing Safe Food Team</p>
+    `,
+  }),
+
+  pantrySubmitsFoodRequest: (params: {
+    pantryName: string;
+  }): EmailTemplate => ({
+    subject: `${params.pantryName} Request Requires Your Review`,
+    bodyHTML: `
+      <p>Hi,</p>
+      <p>
+        A new food request has been submitted by ${params.pantryName}. 
+        Please log on to the SSF platform to review these request details and begin coordination when ready.
+      </p>
+      <p>
+        Thank you for your continued support of our network and mission!
+      <p>Best regards,<br />The Securing Safe Food Team</p>
+    `,
+  }),
+};

apps/backend/src/foodManufacturers/manufacturers.module.ts

@@ -5,11 +5,13 @@ import { FoodManufacturersController } from './manufacturers.controller';
 import { FoodManufacturersService } from './manufacturers.service';
 import { UsersModule } from '../users/users.module';
 import { Donation } from '../donations/donations.entity';
+import { EmailsModule } from '../emails/email.module';
 
 @Module({
   imports: [
     TypeOrmModule.forFeature([FoodManufacturer, Donation]),
     forwardRef(() => UsersModule),
+    EmailsModule,
   ],
   controllers: [FoodManufacturersController],
   providers: [FoodManufacturersService],