feat(providers): integrate Microsoft Graph email provider

apps/api/src/app/integrations/dtos/credentials.dto.ts

@@ -226,6 +226,11 @@ export class CredentialsDto implements ICredentials {
   @IsString()
   @IsOptional()
   senderId?: string;
+
+  @ApiPropertyOptional()
+  @IsString()
+  @IsOptional()
+  tenantId?: string;
 
   @ApiPropertyOptional()
   @IsOptional()

libs/application-generic/src/factories/mail/handlers/index.ts

@@ -18,3 +18,4 @@ export * from './sendgrid.handler';
 export * from './sendinblue.handler';
 export * from './ses.handler';
 export * from './sparkpost.handler';
+export * from './msgraph.handler';

libs/application-generic/src/factories/mail/handlers/msgraph.handler.ts

@@ -0,0 +1,21 @@
+import { MsGraphEmailProvider } from '@novu/providers';
+import { ChannelTypeEnum, EmailProviderIdEnum, ICredentials } from '@novu/shared';
+import { BaseEmailHandler } from './base.handler';
+
+export class MsGraphHandler extends BaseEmailHandler {
+  constructor() {
+    super(EmailProviderIdEnum.MsGraph, ChannelTypeEnum.EMAIL);
+  }
+
+  buildProvider(credentials: ICredentials) {
+    const config = {
+      clientId: credentials.clientId as string,
+      clientSecret: credentials.secretKey as string,
+      tenantId: credentials.tenantId as string,
+      from: credentials.from as string,
+      senderName: credentials.senderName as string,
+    };    
+
+    this.provider = new MsGraphEmailProvider(config);
+  }
+}

libs/application-generic/src/factories/mail/mail.factory.ts

@@ -20,6 +20,7 @@ import {
   SendgridHandler,
   SendinblueHandler,
   SparkPostHandler,
+  MsGraphHandler,
 } from './handlers';
 import { IMailFactory, IMailHandler } from './interfaces';
 
@@ -45,6 +46,7 @@ export class MailFactory implements IMailFactory {
     new EmailWebhookHandler(),
     new NovuEmailHandler(),
     new BrazeEmailHandler(),
+    new MsGraphHandler(),
   ];
 
   getHandler(

libs/dal/src/repositories/integration/integration.schema.ts

@@ -64,6 +64,8 @@ const integrationSchema = new Schema<IntegrationDBModel>(
       accessKey: Schema.Types.String,
       appSid: Schema.Types.String,
       senderId: Schema.Types.String,
+      servicePlanId: Schema.Types.String,      
+      tenantId: Schema.Types.String,
       servicePlanId: Schema.Types.String,
       AppIOBaseUrl: Schema.Types.String,
       AppIOSubscriptionId: Schema.Types.String,

packages/framework/src/schemas/providers/email/index.ts

@@ -29,4 +29,5 @@ export const emailProviderSchemas = {
   sendinblue: genericProviderSchemas,
   ses: genericProviderSchemas,
   sparkpost: genericProviderSchemas,
+  msgraph: genericProviderSchemas,
 } as const satisfies Record<EmailProviderIdEnum, { output: JsonSchema }>;

packages/framework/src/shared.ts

@@ -121,6 +121,7 @@ export enum EmailProviderIdEnum {
   SparkPost = 'sparkpost',
   EmailWebhook = 'email-webhook',
   Braze = 'braze',
+  MsGraph = 'msgraph',
 }
 
 export enum SmsProviderIdEnum {

packages/providers/src/lib/email/index.ts

@@ -21,3 +21,4 @@ export * from './ses/ses.config';
 export * from './ses/ses.provider';
 export * from './sparkpost/sparkpost.error';
 export * from './sparkpost/sparkpost.provider';
+export * from './msgraph-mail/msgraph-mail.provider';