feat: Implement Send Invoice Email to Recipient (#1006)

* Implement Invoice CRUD opteration of FE and BE

* fix backend api issues

* delete not required files and folder from FE and BE

* implement update, create and delete invoice

* Implement Invoice CRUD opteration of FE and BE

* fix backend api issues

* delete not required files and folder from FE and BE

* implement update, create and delete invoice

* formatting

* fix merge conflict errors

* feat: SRS-1002 Implement the file upload feature and integrate it with coms (#1000)

* complete implementation of upload invoice attachment

* formatting

* fix merfe issue and minor css

* key required in openshift

* formatting

* implement api to send invoice email with attachment

* implement send invoice email on frontend

* fix dropdown css issues

* graphql

* auto generated graphql

* fix minor issues and merge conflict

* formatting

Author: jaspalsingh-aot

backend/cats/package-lock.json

@@ -38,7 +38,7 @@
     "@nestjs/common": "^9.0.0",
     "@nestjs/core": "^9.0.0",
     "@nestjs/graphql": "^10.1.3",
-    "@nestjs/platform-express": "^9.0.0",
+    "@nestjs/platform-express": "^9.4.3",
     "@nestjs/typeorm": "^10.0.2",
     "apollo-server-express": "^3.10.2",
     "axios": "^1.7.9",
@@ -47,6 +47,7 @@
     "date-fns": "^4.1.0",
     "graphql": "^16.6.0",
     "keycloak-connect": "^18.0.2",
+    "multer": "^2.0.2",
     "nest-keycloak-connect": "^1.9.0",
     "pg": "^8.8.0",
     "reflect-metadata": "^0.1.13",
@@ -70,6 +71,7 @@
     "@nestjs/testing": "^9.0.0",
     "@types/express": "^4.17.13",
     "@types/jest": "28.1.8",
+    "@types/multer": "^2.0.0",
     "@types/node": "^16.0.0",
     "@types/supertest": "^2.0.11",
     "@typescript-eslint/eslint-plugin": "^5.0.0",

backend/cats/package.json

@@ -95,6 +95,7 @@ import { ServiceAssignmentFactor } from './entities/serviceAssignmentFactor';
 import { PermissionServiceType } from './entities/permissionServiceType';
 import { ApplicationSite } from './entities/applicationSite.entity';
 import { InvoiceItem } from './entities/invoiceItem.entity';
+import { EmailController } from './controllers/email.controller';
 
 /**
  * Module for wrapping all functionalities in user microserivce
@@ -200,6 +201,6 @@ import { InvoiceItem } from './entities/invoiceItem.entity';
     DashboardService,
     DashboardResolver,
   ],
-  controllers: [UserController],
+  controllers: [UserController, EmailController],
 })
 export class CatsModule { }

backend/cats/src/app/cats.module.ts

@@ -0,0 +1,69 @@
+import { Body, Controller, Post, UploadedFile, UseInterceptors, UsePipes, ValidationPipe } from '@nestjs/common';
+import { Resource} from 'nest-keycloak-connect';
+import { LoggerService } from '../logger/logger.service';
+import { FileInterceptor } from '@nestjs/platform-express/multer/interceptors/file.interceptor';
+import { InvoiceEmail } from '../dto/invoice/invoiceEmail/invoiceEmail.dto';
+import { InvoiceService } from '../services/invoice/invoice.service';
+import { HttpStatusCode } from 'axios';
+
+@Controller('email')
+@Resource('cats-service')
+export class EmailController {
+    constructor(
+        private readonly invoiceService: InvoiceService,
+        private readonly loggerService: LoggerService,
+    ) {}
+
+    @Post('/sendEmail')
+    @UseInterceptors(FileInterceptor('file'))
+    @UsePipes(new ValidationPipe({
+        transform: true,
+        transformOptions: { enableImplicitConversion: true },
+        whitelist: true,
+    }))
+    async sendEmail( @UploadedFile() file: Express.Multer.File, @Body() invoiceEmail: InvoiceEmail) {
+        try {
+            let attachments = null;
+            this.loggerService.log('Email controller: sendEmail() start');
+            this.loggerService.log('Email controller: sendEmail() generateInvoicePdf start');
+            if (file) {
+                // Handle the uploaded file directly
+                this.loggerService.log('Email controller: using uploaded file as attachment');
+                attachments =[ 
+                    {
+                        filename: `Invoice-${invoiceEmail.invoiceId}.pdf`,
+                        content: file.buffer.toString('base64'),
+                        encoding: 'base64',
+                    }
+                ];
+            }
+            this.loggerService.log('Email controller: sendEmail() generateInvoicePdf end');
+            
+            if(!attachments) {
+                this.loggerService.log('Email controller: sendEmail() chesEmailService.sendEmail() no attachments start');
+                await this.invoiceService.sendInvoice(invoiceEmail);
+                this.loggerService.log('Email controller: sendEmail() chesEmailService.sendEmail() no attachments end');
+                this.loggerService.log('Email controller: sendEmail() end');
+                return {
+                    message: 'Email sent successfully without attachments',
+                    statusCode: HttpStatusCode.Ok,
+                    success: true
+                };
+            }
+            else {
+                this.loggerService.log('Email controller: sendEmail() chesEmailService.sendEmail() with attachments start');
+                await this.invoiceService.sendInvoice(invoiceEmail, attachments);
+                this.loggerService.log('Email controller: sendEmail() chesEmailService.sendEmail() with attachments end');
+                this.loggerService.log('Email controller: sendEmail() end');
+                return {
+                    message: 'Email sent successfully with attachments',
+                    statusCode: HttpStatusCode.Ok,
+                    success: true
+                };
+            }
+        } 
+        catch (error) {
+            this.loggerService.error('Email controller: sendEmail() error', error);
+        }
+    }
+}

backend/cats/src/app/controllers/email.controller.ts

@@ -15,6 +15,6 @@ export class DropdownDto {
   @Field()
   value: string;
 
-  @Field()
-  metaData?: string;
+  @Field({ nullable: true })
+  metaData?: string | null;
 }

backend/cats/src/app/dto/dropdown.dto.ts

@@ -0,0 +1,19 @@
+import { IsEmail, IsInt, IsNotEmpty, IsOptional, IsString } from "class-validator";
+
+export class InvoiceEmail {
+    @IsNotEmpty()
+    @IsInt()
+    invoiceId: number;
+
+    @IsEmail()
+    @IsNotEmpty()
+    to: string;
+
+    @IsString()
+    @IsOptional()
+    subject?: string | null;
+
+    @IsString()
+    @IsOptional()
+    body?: string | null;
+}