core-services-sdk 1.2.3 → 1.3.0

package/index.js

@@ -0,0 +1,3 @@
+import { HttpError } from './src/index.js'
+
+throw new HttpError({ code: '2', httpStatusCode: 22 })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "core-services-sdk",
-  "version": "1.2.3",
+  "version": "1.3.0",
   "main": "src/index.js",
   "type": "module",
   "scripts": {
@@ -20,9 +20,12 @@
   "description": "",
   "dependencies": {
     "amqplib": "^0.10.8",
+    "aws-sdk": "^2.1692.0",
     "http-status": "^2.1.0",
     "mongodb": "^6.17.0",
     "node-fetch": "^3.3.2",
+    "nodemailer": "^7.0.5",
+    "nodemailer-sendgrid-transport": "^0.2.0",
     "uuid": "^11.1.0",
     "xml2js": "^0.6.2"
   },

package/src/index.js

@@ -4,4 +4,7 @@ export * from './mongodb/connect.js'
 export * from './rabbit-mq/index.js'
 export * as http from './http/http.js'
 export * from './http/responseType.js'
+export { initMailer } from './mailer/index.js'
 export { HttpError } from './http/HttpError.js'
+export { Mailer } from './mailer/mailer.service.js'
+export { TransportFactory } from './mailer/transport.factory.js'

package/src/mailer/index.js

@@ -0,0 +1,9 @@
+import { Mailer } from './mailer.service.js'
+import { TransportFactory } from './transport.factory.js'
+
+export const initMailer = (config) => {
+  const transport = TransportFactory.create(config)
+  const mailer = new Mailer(transport)
+
+  return mailer
+}

package/src/mailer/mailer.service.js

@@ -0,0 +1,28 @@
+export class Mailer {
+  /**
+   * @param {object} transporter - Nodemailer transporter instance
+   */
+  constructor(transporter) {
+    if (!transporter || typeof transporter.sendMail !== 'function') {
+      throw new Error('Invalid transporter')
+    }
+    this.transporter = transporter
+  }
+
+  /**
+   * Send an email
+   */
+  async send({ to, subject, html, text, from, cc, bcc, replyTo, attachments }) {
+    return this.transporter.sendMail({
+      to,
+      cc,
+      bcc,
+      text,
+      from,
+      html,
+      subject,
+      replyTo,
+      attachments,
+    })
+  }
+}

package/src/mailer/transport.factory.js

@@ -0,0 +1,45 @@
+import aws from 'aws-sdk'
+import nodemailer from 'nodemailer'
+import sgTransport from 'nodemailer-sendgrid-transport'
+
+export class TransportFactory {
+  /**
+   * @param {object} config
+   * @returns {import('nodemailer').Transporter}
+   */
+  static create(config) {
+    switch (config.type) {
+      case 'smtp':
+        return nodemailer.createTransport({
+          host: config.host,
+          port: config.port,
+          secure: config.secure,
+          auth: config.auth,
+        })
+
+      case 'gmail':
+        return nodemailer.createTransport({
+          service: 'gmail',
+          auth: config.auth,
+        })
+
+      case 'sendgrid':
+        return nodemailer.createTransport(
+          sgTransport({
+            auth: { api_key: config.apiKey },
+          }),
+        )
+
+      case 'ses':
+        const ses = new aws.SES({
+          accessKeyId: config.accessKeyId,
+          secretAccessKey: config.secretAccessKey,
+          region: config.region,
+        })
+        return nodemailer.createTransport({ SES: { ses, aws } })
+
+      default:
+        throw new Error(`Unsupported transport type: ${config.type}`)
+    }
+  }
+}

package/src/mongodb/index.js

@@ -48,15 +48,17 @@ export const initializeMongoDb = async ({ config, collectionNames = {} }) => {
 
   const withTransaction = async (action) => {
     const session = client.startSession()
+    let actionResponse
     try {
       session.startTransaction()
-      await action({ session })
+      actionResponse = await action({ session })
       await session.commitTransaction()
     } catch (error) {
       await session.abortTransaction()
       throw error
     } finally {
       await session.endSession()
+      return actionResponse
     }
   }
 

package/tests/mailer.integration.test.js

@@ -0,0 +1,46 @@
+import { describe, it, expect } from 'vitest'
+import nodemailer from 'nodemailer'
+import { Mailer } from '../src/mailer/mailer.service.js'
+
+describe('Mailer (integration)', () => {
+  it('should send email using ethereal SMTP', async () => {
+    // Create ethereal test account
+    const testAccount = await nodemailer.createTestAccount()
+
+    // Create Nodemailer transporter for ethereal
+    const transporter = nodemailer.createTransport({
+      host: testAccount.smtp.host,
+      port: testAccount.smtp.port,
+      secure: testAccount.smtp.secure,
+      auth: {
+        user: testAccount.user,
+        pass: testAccount.pass,
+      },
+    })
+
+    // Create Mailer instance
+    const mailer = new Mailer(transporter)
+
+    // Send test email
+    const result = await mailer.send({
+      to: 'recipient@example.com',
+      text: 'Hello from test - plain text',
+      from: '"My App" <no-reply@example.com>',
+      subject: 'core-service-sdk:Integration Test Email',
+      html: '<h1>Hello from core-service-sdk test</h1><p>This is a core-service-sdk</p>',
+      cc: '',
+      bcc: '',
+      replyTo: '',
+      attachments: '',
+    })
+
+    // Assert response
+    expect(result.messageId).toBeDefined()
+
+    // Print preview URL (clickable in terminal)
+    const previewUrl = nodemailer.getTestMessageUrl(result)
+    console.log(`📨 Preview this email: ${previewUrl}`)
+
+    expect(previewUrl).toMatch(/^https:\/\/ethereal\.email/)
+  })
+})

package/tests/mailer.unit.test.js

@@ -0,0 +1,68 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+
+const mockTransport = {
+  sendMail: vi.fn(),
+}
+
+// Dynamically mock the TransportFactory module and turn .create into a spy
+vi.mock('../src/mailer/transport.factory.js', async () => {
+  const actual = await vi.importActual('../src/mailer/transport.factory.js')
+  return {
+    ...actual,
+    TransportFactory: {
+      create: vi.fn(() => mockTransport),
+    },
+  }
+})
+
+// Mock Mailer class
+vi.mock('../src/mailer/mailer.service.js', async () => {
+  const Mailer = vi.fn().mockImplementation((transport) => ({
+    send: vi.fn((opts) => transport.sendMail(opts)),
+  }))
+  return { Mailer }
+})
+
+// Only now import code under test
+import { initMailer } from '../src/mailer/index.js'
+import { TransportFactory } from '../src/mailer/transport.factory.js'
+import { Mailer } from '../src/mailer/mailer.service.js'
+
+describe('initMailer', () => {
+  beforeEach(() => {
+    vi.clearAllMocks()
+  })
+
+  it('should create a Mailer instance with correct transport', () => {
+    const config = {
+      type: 'smtp',
+      host: 'host',
+      port: 587,
+      secure: false,
+      auth: { user: 'u', pass: 'p' },
+    }
+
+    const mailer = initMailer(config)
+
+    // Ensure TransportFactory.create was called
+    expect(TransportFactory.create).toHaveBeenCalledWith(config)
+
+    // Ensure Mailer was created with the mock transport
+    expect(Mailer).toHaveBeenCalledWith(mockTransport)
+
+    const emailOptions = {
+      to: 'a@b.com',
+      subject: 'Test',
+      html: '<b>Test</b>',
+      from: '"My App" <no-reply@example.com>',
+      cc: '',
+      bcc: '',
+      text: '',
+      replyTo: '',
+      attachments: '',
+    }
+
+    mailer.send(emailOptions)
+    expect(mockTransport.sendMail).toHaveBeenCalledWith(emailOptions)
+  })
+})