@b2y/email-service 1.1.0 → 1.2.0

package/Config.js

@@ -19,6 +19,10 @@ const Config = {
   postmarkApiKey: process.env.ACCESS_KEY,
   postmarkFromEmail: process.env.FROM_EMAIL,
   
+  // MailGun Configuration
+  mailgunApiKey: process.env.ACCESS_KEY,
+  mailgunDomain: process.env.ACCESS_DOMAIN,
+  
   // Amazon SES Configuration
   awsRegion: process.env.REGION,
   awsAccessKeyId: process.env.ACCESS_KEY,

package/constants/AppConstants.js

@@ -0,0 +1,8 @@
+
+const AppConstants = {
+    
+   // Mailgun requires literal string 'api' as username - this is their API standard 
+   MAILGUN_AUTH_USERNAME : 'api' 
+};
+
+module.exports = AppConstants;

package/constants/StatusMessageConstants.js

@@ -33,7 +33,8 @@ const StatusMessage = {
   NODEMAILER_SEND_ERROR:'Nodemailer failed to send email',
   POSTMARK_SEND_ERROR:'Postmark failed to send email',
   SENDGRID_SEND_ERROR:'SendGrid failed to send email',
-  AMAZON_SES_SEND_ERROR: 'Amazon SES failed to send email'
+  AMAZON_SES_SEND_ERROR: 'Amazon SES failed to send email',
+  MAILGUN_SEND_ERROR: 'Mailgun failed to send email',
 };
 
 module.exports = StatusMessage;

package/enum/EmailProvider.js

@@ -2,7 +2,8 @@ const EmailProvider = {
   NODE_MAILER: 'nodemailer',
   SENDGRID: 'sendgrid',
   POSTMARK: 'postmark',
-  AMAZON_SES: 'amazonses'
+  AMAZON_SES: 'amazonses',
+  MAILGUN: 'mailgun'
 };
 
 module.exports = { EmailProvider };

package/index.js

@@ -3,6 +3,7 @@ const NodeMailerProvider = require('./providers/NodeMailerProvider');
 const SendgridProvider = require('./providers/SendgridProvider');
 const PostmarkProvider = require('./providers/PostmarkProvider');
 const AmazonSesProvider = require('./providers/AmazonSESProvider');
+const MailgunProvider = require('./providers/MailgunProvider');
 const TemplateEngine = require('./utils/TemplateEngine');
 const EmailService = require('./service/EmailService');
 const Config = require('./Config');
@@ -10,6 +11,7 @@ const logger = require('./Logger');
 const { sequelize, EmailTemplate } = require('./model/Connect');
 const { EmailProvider } = require('./enum/EmailProvider');
 const StatusMessage = require('./constants/StatusMessageConstants');
+
 // Initialize database connection
 async function initializeDatabase() {
   try {
@@ -35,6 +37,8 @@ function createEmailProvider() {
       return new PostmarkProvider();
     case EmailProvider.AMAZON_SES:
       return new AmazonSesProvider();
+    case EmailProvider.MAILGUN:
+      return new MailgunProvider();
     default:
       logger.warn(StatusMessage.PROVIDER_DEFAULT_FALLBACK);
       return new NodeMailerProvider();
@@ -69,6 +73,7 @@ module.exports = {
   SendgridProvider,
   PostmarkProvider,
   AmazonSesProvider,
+  MailgunProvider,
   EmailService,
   TemplateEngine,
   createEmailProvider,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@b2y/email-service",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "main": "index.js",
   "exports": {
     ".": "./index.js",
@@ -42,8 +42,10 @@
     "@sendgrid/mail": "^8.1.5",
     "b2y-logger": "^1.1.0",
     "dotenv": "^16.5.0",
+    "form-data": "^4.0.5",
     "handlebars": "^4.7.8",
     "log4js": "^6.9.1",
+    "mailgun.js": "^12.7.0",
     "nodemailer": "^6.10.0",
     "pg": "^8.16.3",
     "pg-hstore": "^2.3.4",

package/providers/MailgunProvider.js

@@ -0,0 +1,85 @@
+// providers/MailgunProvider.js
+const formData = require('form-data');
+const Mailgun = require('mailgun.js');
+const BaseProvider = require('./BaseProvider');
+const Config = require('../Config');
+const logger = require('../Logger');
+const StatusMessage = require('../constants/StatusMessageConstants');
+const { EmailProvider } = require('../enum/EmailProvider');
+const AppConstants = require('../constants/AppConstants');
+class MailgunProvider extends BaseProvider {
+  constructor() {
+    super();
+    
+    if (!Config.mailgunApiKey) {
+      throw new Error('Mailgun API key is required');
+    }
+    
+    if (!Config.mailgunDomain) {
+      throw new Error('Mailgun domain is required');
+    }
+    
+    const mailgun = new Mailgun(formData);
+    this.client = mailgun.client({
+      username: AppConstants.MAILGUN_AUTH_USERNAME,
+      key: Config.mailgunApiKey
+    });
+    this.domain = Config.mailgunDomain;
+  }
+
+  async sendEmail(options) {
+    try {
+      this.validateEmailOptions(options);
+      
+      const messageData = {
+        from: this.formatFromAddress(
+          options.from || Config.fromEmail,
+          options.fromName || Config.fromName
+        ),
+        to: this.formatRecipients(options.to),
+        subject: options.subject,
+        html: options.html
+      };
+      
+      // Add CC if present
+      if (options.cc && options.cc.length > 0) {
+        messageData.cc = this.formatRecipients(options.cc);
+      }
+      
+      // Add BCC if present
+      if (options.bcc && options.bcc.length > 0) {
+        messageData.bcc = this.formatRecipients(options.bcc);
+      }
+      
+      // Add attachments if present
+      if (options.attachments && options.attachments.length > 0) {
+        messageData.attachment = options.attachments.map(att => ({
+          filename: att.filename,
+          data: att.content,
+          contentType: att.contentType
+        }));
+      }
+      
+      const result = await this.client.messages.create(this.domain, messageData);
+      
+      logger.info('Email sent successfully via Mailgun', {
+        messageId: result.id,
+        recipients: { to: options.to, cc: options.cc, bcc: options.bcc },
+        tenantId: options.tenantId,
+        from: messageData.from
+      });
+      
+      return {
+        success: true,
+        messageId: result.id,
+        provider: EmailProvider.MAILGUN,
+        tenantId: options.tenantId
+      };
+    } catch (error) {
+      logger.error('Mailgun failed to send email:', error);
+      throw new Error(StatusMessage.MAILGUN_SEND_ERROR);
+    }
+  }
+}
+
+module.exports = MailgunProvider;