Feat/update practitioner email

backend/compact-connect/lambdas/nodejs/email-notification-service/lambda.ts

@@ -317,6 +317,32 @@ export class Lambda implements LambdaInterface {
                 event.specificEmails
             );
             break;
+        case 'providerEmailVerificationCode':
+            if (!event.specificEmails?.length) {
+                throw new Error('No recipients found for provider email verification code email');
+            }
+            if (!event.templateVariables?.verificationCode) {
+                throw new Error('Missing required template variables for providerEmailVerificationCode template');
+            }
+            await this.emailService.sendProviderEmailVerificationCode(
+                event.compact,
+                event.specificEmails[0],
+                event.templateVariables.verificationCode
+            );
+            break;
+        case 'providerEmailChangeNotification':
+            if (!event.specificEmails?.length) {
+                throw new Error('No recipients found for provider email change notification email');
+            }
+            if (!event.templateVariables?.newEmailAddress) {
+                throw new Error('Missing required template variables for providerEmailChangeNotification template');
+            }
+            await this.emailService.sendProviderEmailChangeNotification(
+                event.compact,
+                event.specificEmails[0],
+                event.templateVariables.newEmailAddress
+            );
+            break;
         default:
             logger.info('Unsupported email template provided', { template: event.template });
             throw new Error(`Unsupported email template: ${event.template}`);

backend/compact-connect/lambdas/nodejs/lib/email/email-notification-service.ts

@@ -367,4 +367,60 @@ export class EmailNotificationService extends BaseEmailService {
 
         await this.sendEmail({ htmlContent, subject, recipients, errorMessage: 'Unable to send multiple registration attempt notification email' });
     }
+
+    /**
+     * Sends a verification code to a provider's new email address during email change process
+     * @param compact - The compact name
+     * @param providerEmail - The new email address to send the verification code to
+     * @param verificationCode - The 4-digit verification code
+     */
+    public async sendProviderEmailVerificationCode(
+        compact: string,
+        providerEmail: string,
+        verificationCode: string
+    ): Promise<void> {
+        this.logger.info('Sending provider email verification code', { compact: compact, providerEmail: providerEmail });
+
+        const recipients = [providerEmail];
+
+        const report = this.getNewEmailTemplate();
+        const subject = `Verify Your New Email Address - Compact Connect`;
+        const bodyText = `Please use the following verification code to complete your email address change:\n\n## ${verificationCode}\n\nThis code will expire in 15 minutes.\n\nIf you did not request this email change, please contact support immediately.`;
+
+        this.insertHeader(report, 'Email Update Verification');
+        this.insertBody(report, bodyText, 'center', true);
+        this.insertFooter(report);
+
+        const htmlContent = renderToStaticMarkup(report, { rootBlockId: 'root' });
+
+        await this.sendEmail({ htmlContent, subject, recipients, errorMessage: 'Unable to send email verification code' });
+    }
+
+    /**
+     * Sends a notification to the old email address when a provider's email is successfully changed
+     * @param compact - The compact name
+     * @param oldEmailAddress - The previous email address to notify
+     * @param newEmailAddress - The new email address that was set
+     */
+    public async sendProviderEmailChangeNotification(
+        compact: string,
+        oldEmailAddress: string,
+        newEmailAddress: string
+    ): Promise<void> {
+        this.logger.info('Sending provider email change notification', { compact: compact, oldEmailAddress: oldEmailAddress });
+
+        const recipients = [oldEmailAddress];
+
+        const report = this.getNewEmailTemplate();
+        const subject = `Email Address Changed - Compact Connect`;
+        const bodyText = `This is to notify you that your Compact Connect account email address has been changed to the following:\n\n${newEmailAddress}\n\nPlease use the new email address to login to your account from now on. If you did not make this change, please contact support immediately.`;
+
+        this.insertHeader(report, 'Email Address Changed');
+        this.insertBody(report, bodyText, 'center');
+        this.insertFooter(report);
+
+        const htmlContent = renderToStaticMarkup(report, { rootBlockId: 'root' });
+
+        await this.sendEmail({ htmlContent, subject, recipients, errorMessage: 'Unable to send email change notification' });
+    }
 }

backend/compact-connect/lambdas/nodejs/tests/email-notification-service.test.ts

@@ -1174,4 +1174,147 @@ describe('EmailNotificationServiceLambda', () => {
                 .toThrow('Missing required jurisdiction field for privilegeEncumbranceLiftingStateNotification template.');
         });
     });
+
+    describe('Provider Email Verification Code', () => {
+        const SAMPLE_PROVIDER_EMAIL_VERIFICATION_CODE_EVENT: EmailNotificationEvent = {
+            template: 'providerEmailVerificationCode',
+            recipientType: 'SPECIFIC',
+            compact: 'aslp',
+            specificEmails: ['[email protected]'],
+            templateVariables: {
+                verificationCode: '1234'
+            }
+        };
+
+        it('should successfully send provider email verification code email', async () => {
+            const response = await lambda.handler(SAMPLE_PROVIDER_EMAIL_VERIFICATION_CODE_EVENT, {} as any);
+
+            expect(response).toEqual({
+                message: 'Email message sent'
+            });
+
+            // Verify email was sent
+            expect(mockSESClient).toHaveReceivedCommandWith(SendEmailCommand, {
+                Destination: {
+                    ToAddresses: ['[email protected]']
+                },
+                Message: {
+                    Body: {
+                        Html: {
+                            Charset: 'UTF-8',
+                            Data: expect.any(String)
+                        }
+                    },
+                    Subject: {
+                        Charset: 'UTF-8',
+                        Data: 'Verify Your New Email Address - Compact Connect'
+                    }
+                },
+                Source: 'Compact Connect <[email protected]>'
+            });
+
+            // Get the actual HTML content for detailed validation
+            const emailCall = mockSESClient.commandCalls(SendEmailCommand)[0];
+            const htmlContent = emailCall.args[0].input.Message?.Body?.Html?.Data;
+
+            expect(htmlContent).toBeDefined();
+            expect(htmlContent).toContain('Please use the following verification code to complete your email address change');
+            expect(htmlContent).toContain('<h2>1234</h2>');
+            expect(htmlContent).toContain('This code will expire in 15 minutes');
+            expect(htmlContent).toContain('If you did not request this email change, please contact support immediately');
+            expect(htmlContent).toContain('Email Update Verification');
+        });
+
+        it('should throw error when no recipients found', async () => {
+            const eventWithNoRecipients: EmailNotificationEvent = {
+                ...SAMPLE_PROVIDER_EMAIL_VERIFICATION_CODE_EVENT,
+                specificEmails: []
+            };
+
+            await expect(lambda.handler(eventWithNoRecipients, {} as any))
+                .rejects
+                .toThrow('No recipients found for provider email verification code email');
+        });
+
+        it('should throw error when verification code is missing', async () => {
+            const eventWithMissingCode: EmailNotificationEvent = {
+                ...SAMPLE_PROVIDER_EMAIL_VERIFICATION_CODE_EVENT,
+                templateVariables: {}
+            };
+
+            await expect(lambda.handler(eventWithMissingCode, {} as any))
+                .rejects
+                .toThrow('Missing required template variables for providerEmailVerificationCode template');
+        });
+    });
+
+    describe('Provider Email Change Notification', () => {
+        const SAMPLE_PROVIDER_EMAIL_CHANGE_NOTIFICATION_EVENT: EmailNotificationEvent = {
+            template: 'providerEmailChangeNotification',
+            recipientType: 'SPECIFIC',
+            compact: 'aslp',
+            specificEmails: ['[email protected]'],
+            templateVariables: {
+                newEmailAddress: '[email protected]'
+            }
+        };
+
+        it('should successfully send provider email change notification email', async () => {
+            const response = await lambda.handler(SAMPLE_PROVIDER_EMAIL_CHANGE_NOTIFICATION_EVENT, {} as any);
+
+            expect(response).toEqual({
+                message: 'Email message sent'
+            });
+
+            // Verify email was sent with correct parameters
+            expect(mockSESClient).toHaveReceivedCommandWith(SendEmailCommand, {
+                Destination: {
+                    ToAddresses: ['[email protected]']
+                },
+                Message: {
+                    Body: {
+                        Html: {
+                            Charset: 'UTF-8',
+                            Data: expect.any(String)
+                        }
+                    },
+                    Subject: {
+                        Charset: 'UTF-8',
+                        Data: 'Email Address Changed - Compact Connect'
+                    }
+                },
+                Source: 'Compact Connect <[email protected]>'
+            });
+
+            // Get the actual HTML content for detailed validation
+            const emailCall = mockSESClient.commandCalls(SendEmailCommand)[0];
+            const htmlContent = emailCall.args[0].input.Message?.Body?.Html?.Data;
+
+            expect(htmlContent).toBeDefined();
+            expect(htmlContent).toContain('This is to notify you that your Compact Connect account email address has been changed to the following:');
+            expect(htmlContent).toContain('[email protected]');
+        });
+
+        it('should throw error when no recipients found', async () => {
+            const eventWithNoRecipients: EmailNotificationEvent = {
+                ...SAMPLE_PROVIDER_EMAIL_CHANGE_NOTIFICATION_EVENT,
+                specificEmails: []
+            };
+
+            await expect(lambda.handler(eventWithNoRecipients, {} as any))
+                .rejects
+                .toThrow('No recipients found for provider email change notification email');
+        });
+
+        it('should throw error when new email address is missing', async () => {
+            const eventWithMissingEmail: EmailNotificationEvent = {
+                ...SAMPLE_PROVIDER_EMAIL_CHANGE_NOTIFICATION_EVENT,
+                templateVariables: {}
+            };
+
+            await expect(lambda.handler(eventWithMissingEmail, {} as any))
+                .rejects
+                .toThrow('Missing required template variables for providerEmailChangeNotification template');
+        });
+    });
 });

backend/compact-connect/lambdas/nodejs/tests/lib/email/email-notification-service.test.ts

@@ -698,4 +698,88 @@ describe('EmailNotificationService', () => {
             )).rejects.toThrow('No recipients found');
         });
     });
+
+    describe('Provider Email Verification Code', () => {
+        it('should send email verification code with all expected content', async () => {
+            const verificationCode = '1234';
+
+            await emailService.sendProviderEmailVerificationCode(
+                'aslp',
+                '[email protected]',
+                verificationCode
+            );
+
+            // Check overall email structure and each content piece
+            // Verify email was sent
+            expect(mockSESClient).toHaveReceivedCommandWith(SendEmailCommand, {
+                Destination: {
+                    ToAddresses: ['[email protected]']
+                },
+                Message: {
+                    Body: {
+                        Html: {
+                            Charset: 'UTF-8',
+                            Data: expect.any(String)
+                        }
+                    },
+                    Subject: {
+                        Charset: 'UTF-8',
+                        Data: 'Verify Your New Email Address - Compact Connect'
+                    }
+                },
+                Source: 'Compact Connect <[email protected]>'
+            });
+
+            // Get the actual HTML content for detailed validation
+            const emailCall = mockSESClient.commandCalls(SendEmailCommand)[0];
+            const htmlContent = emailCall.args[0].input.Message?.Body?.Html?.Data;
+
+            expect(htmlContent).toBeDefined();
+            expect(htmlContent).toContain('Please use the following verification code to complete your email address change');
+            expect(htmlContent).toContain(`<h2>${verificationCode}</h2>`);
+            expect(htmlContent).toContain('This code will expire in 15 minutes');
+            expect(htmlContent).toContain('If you did not request this email change, please contact support immediately');
+            expect(htmlContent).toContain('Email Update Verification');
+        });
+    });
+
+    describe('Provider Email Change Notification', () => {
+        it('should send email change notification with all expected content', async () => {
+            await emailService.sendProviderEmailChangeNotification(
+                'aslp',
+                '[email protected]',
+                '[email protected]'
+            );
+
+            // Verify email was sent
+            expect(mockSESClient).toHaveReceivedCommandWith(SendEmailCommand, {
+                Destination: {
+                    ToAddresses: ['[email protected]']
+                },
+                Message: {
+                    Body: {
+                        Html: {
+                            Charset: 'UTF-8',
+                            Data: expect.any(String)
+                        }
+                    },
+                    Subject: {
+                        Charset: 'UTF-8',
+                        Data: 'Email Address Changed - Compact Connect'
+                    }
+                },
+                Source: 'Compact Connect <[email protected]>'
+            });
+
+            // Get the actual HTML content for detailed validation
+            const emailCall = mockSESClient.commandCalls(SendEmailCommand)[0];
+            const htmlContent = emailCall.args[0].input.Message?.Body?.Html?.Data;
+
+            expect(htmlContent).toBeDefined();
+            expect(htmlContent).toContain('Please use the new email address to login to your account from now on.');
+            expect(htmlContent).toContain('If you did not make this change, please contact support immediately.');
+            expect(htmlContent).toContain('Email Address Changed');
+            expect(htmlContent).toContain('[email protected]');
+        });
+    });
 });