Implement functionality for sending books via email

Author: aditya.chandel

booklore-api/build.gradle

@@ -34,6 +34,7 @@ dependencies {
     implementation 'org.springframework.boot:spring-boot-starter-actuator'
     implementation 'org.springframework.boot:spring-boot-configuration-processor'
     implementation 'org.springframework.boot:spring-boot-starter-security'
+    implementation 'org.springframework.boot:spring-boot-starter-mail'
 
     // --- Database & Migration ---
     implementation 'org.mariadb.jdbc:mariadb-java-client:3.5.2'

booklore-api/src/main/java/com/adityachandel/booklore/config/security/JwtAuthenticationFilter.java

@@ -83,6 +83,7 @@ private BookLoreUser mapToDTO(BookLoreUserEntity userEntity) {
         permissions.setCanUpload(userEntity.getPermissions().isPermissionUpload());
         permissions.setCanDownload(userEntity.getPermissions().isPermissionDownload());
         permissions.setCanEditMetadata(userEntity.getPermissions().isPermissionEditMetadata());
+        permissions.setCanEmailBook(userEntity.getPermissions().isPermissionEmailBook());
         permissions.setCanManipulateLibrary(userEntity.getPermissions().isPermissionManipulateLibrary());
 
         BookLoreUser bookLoreUser = new BookLoreUser();

booklore-api/src/main/java/com/adityachandel/booklore/config/security/SecurityConfig.java

@@ -56,7 +56,7 @@ public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Excepti
     public CorsConfigurationSource corsConfigurationSource() {
         CorsConfiguration configuration = new CorsConfiguration();
         configuration.setAllowedOriginPatterns(List.of("*"));
-        configuration.setAllowedMethods(List.of("GET", "POST", "PUT", "DELETE", "OPTIONS"));
+        configuration.setAllowedMethods(List.of("GET", "POST", "PUT", "DELETE", "OPTIONS" , "PATCH"));
         configuration.setAllowedHeaders(List.of("Authorization", "Cache-Control", "Content-Type"));
         configuration.setExposedHeaders(List.of("Content-Disposition"));
         configuration.setAllowCredentials(true);

booklore-api/src/main/java/com/adityachandel/booklore/config/security/SecurityUtil.java

@@ -52,6 +52,14 @@ public boolean canEditMetadata() {
         return false;
     }
 
+    public boolean canEmailBook() {
+        var authentication = SecurityContextHolder.getContext().getAuthentication();
+        if (authentication != null && authentication.getPrincipal() instanceof BookLoreUser user) {
+            return user.getPermissions().isCanEmailBook();
+        }
+        return false;
+    }
+
     public boolean canViewUserProfile(Long userId) {
         var authentication = SecurityContextHolder.getContext().getAuthentication();
         if (authentication != null && authentication.getPrincipal() instanceof BookLoreUser user) {

booklore-api/src/main/java/com/adityachandel/booklore/controller/EmailController.java

@@ -0,0 +1,31 @@
+package com.adityachandel.booklore.controller;
+
+import com.adityachandel.booklore.model.dto.request.SendBookByEmailRequest;
+import com.adityachandel.booklore.service.EmailService;
+import lombok.AllArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+@AllArgsConstructor
+@RestController
+@RequestMapping("/api/v1/emails")
+public class EmailController {
+
+    private final EmailService emailService;
+
+    @PreAuthorize("@securityUtil.canEmailBook() or @securityUtil.isAdmin()")
+    @PostMapping("/send-book")
+    public ResponseEntity<?> sendEmail(@Validated @RequestBody SendBookByEmailRequest request) {
+        emailService.emailBook(request);
+        return ResponseEntity.noContent().build();
+    }
+
+    @PreAuthorize("@securityUtil.canEmailBook() or @securityUtil.isAdmin()")
+    @PostMapping("/send-book/{bookId}")
+    public ResponseEntity<?> emailBookQuick(@PathVariable Long bookId) {
+        emailService.emailBookQuick(bookId);
+        return ResponseEntity.noContent().build();
+    }
+}

booklore-api/src/main/java/com/adityachandel/booklore/controller/EmailProviderController.java

@@ -0,0 +1,57 @@
+package com.adityachandel.booklore.controller;
+
+import com.adityachandel.booklore.model.dto.EmailProvider;
+import com.adityachandel.booklore.model.dto.request.CreateEmailProviderRequest;
+import com.adityachandel.booklore.service.EmailProviderService;
+import lombok.AllArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+@AllArgsConstructor
+@RestController
+@RequestMapping("/api/v1/email/providers")
+public class EmailProviderController {
+
+    private final EmailProviderService emailProviderService;
+
+    @PreAuthorize("@securityUtil.isAdmin()")
+    @GetMapping
+    public ResponseEntity<List<EmailProvider>> getEmailProviders() {
+        return ResponseEntity.ok(emailProviderService.getEmailProviders());
+    }
+
+    @PreAuthorize("@securityUtil.isAdmin()")
+    @GetMapping("/{id}")
+    public ResponseEntity<EmailProvider> getEmailProvider(@PathVariable Long id) {
+        return ResponseEntity.ok(emailProviderService.getEmailProvider(id));
+    }
+
+    @PreAuthorize("@securityUtil.isAdmin()")
+    @PostMapping
+    public ResponseEntity<EmailProvider> createEmailProvider(@RequestBody CreateEmailProviderRequest createEmailProviderRequest) {
+        return ResponseEntity.ok(emailProviderService.createEmailProvider(createEmailProviderRequest));
+    }
+
+    @PreAuthorize("@securityUtil.isAdmin()")
+    @PutMapping("/{id}")
+    public ResponseEntity<EmailProvider> updateEmailProvider(@PathVariable Long id, @RequestBody CreateEmailProviderRequest updateRequest) {
+        return ResponseEntity.ok(emailProviderService.updateEmailProvider(id, updateRequest));
+    }
+
+    @PreAuthorize("@securityUtil.isAdmin()")
+    @PatchMapping("/{id}/set-default")
+    public ResponseEntity<Void> setDefaultEmailProvider(@PathVariable Long id) {
+        emailProviderService.setDefaultEmailProvider(id);
+        return ResponseEntity.noContent().build();
+    }
+
+    @PreAuthorize("@securityUtil.isAdmin()")
+    @DeleteMapping("/{id}")
+    public ResponseEntity<?> deleteEmailProvider(@PathVariable Long id) {
+        emailProviderService.deleteEmailProvider(id);
+        return ResponseEntity.noContent().build();
+    }
+}

booklore-api/src/main/java/com/adityachandel/booklore/controller/EmailRecipientController.java

@@ -0,0 +1,57 @@
+package com.adityachandel.booklore.controller;
+
+import com.adityachandel.booklore.model.dto.EmailRecipient;
+import com.adityachandel.booklore.model.dto.request.CreateEmailRecipientRequest;
+import com.adityachandel.booklore.service.EmailRecipientService;
+import lombok.AllArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+@AllArgsConstructor
+@RestController
+@RequestMapping("/api/v1/email/recipients")
+public class EmailRecipientController {
+
+    private final EmailRecipientService emailRecipientService;
+
+    @PreAuthorize("@securityUtil.isAdmin()")
+    @GetMapping
+    public ResponseEntity<List<EmailRecipient>> getEmailRecipients() {
+        return ResponseEntity.ok(emailRecipientService.getEmailRecipients());
+    }
+
+    @PreAuthorize("@securityUtil.isAdmin()")
+    @GetMapping("/{id}")
+    public ResponseEntity<EmailRecipient> getEmailRecipient(@PathVariable Long id) {
+        return ResponseEntity.ok(emailRecipientService.getEmailRecipient(id));
+    }
+
+    @PreAuthorize("@securityUtil.isAdmin()")
+    @PostMapping
+    public ResponseEntity<EmailRecipient> createEmailRecipient(@RequestBody CreateEmailRecipientRequest createEmailRecipientRequest) {
+        return ResponseEntity.ok(emailRecipientService.createEmailRecipient(createEmailRecipientRequest));
+    }
+
+    @PreAuthorize("@securityUtil.isAdmin()")
+    @PutMapping("/{id}")
+    public ResponseEntity<EmailRecipient> updateEmailRecipient(@PathVariable Long id, @RequestBody CreateEmailRecipientRequest updateRequest) {
+        return ResponseEntity.ok(emailRecipientService.updateEmailRecipient(id, updateRequest));
+    }
+
+    @PreAuthorize("@securityUtil.isAdmin()")
+    @PatchMapping("/{id}/set-default")
+    public ResponseEntity<Void> setDefaultEmailRecipient(@PathVariable Long id) {
+        emailRecipientService.setDefaultRecipient(id);
+        return ResponseEntity.noContent().build();
+    }
+
+    @PreAuthorize("@securityUtil.isAdmin()")
+    @DeleteMapping("/{id}")
+    public ResponseEntity<Void> deleteEmailRecipient(@PathVariable Long id) {
+        emailRecipientService.deleteEmailRecipient(id);
+        return ResponseEntity.noContent().build();
+    }
+}

booklore-api/src/main/java/com/adityachandel/booklore/exception/ApiError.java

@@ -7,7 +7,10 @@
 @Getter
 public enum ApiError {
     BOOK_NOT_FOUND(HttpStatus.NOT_FOUND, "Book not found with ID: %d"),
-    USER_NOT_FOUNDD(HttpStatus.NOT_FOUND, "User with ID %s not found"),
+    EMAIL_PROVIDER_NOT_FOUND(HttpStatus.NOT_FOUND, "Email provider with ID %s not found"),
+    DEFAULT_EMAIL_PROVIDER_NOT_FOUND(HttpStatus.NOT_FOUND, "Default email provider not found"),
+    EMAIL_RECIPIENT_NOT_FOUND(HttpStatus.NOT_FOUND, "Email recipient with ID %s not found"),
+    DEFAULT_EMAIL_RECIPIENT_NOT_FOUND(HttpStatus.NOT_FOUND, " Default Email recipient not found"),
     UNSUPPORTED_BOOK_TYPE(HttpStatus.BAD_REQUEST, "Unsupported book type for viewer settings"),
     INVALID_VIEWER_SETTING(HttpStatus.BAD_REQUEST, "Invalid viewer setting for the book"),
     FILE_READ_ERROR(HttpStatus.INTERNAL_SERVER_ERROR, "Error reading files from path"),
@@ -31,6 +34,8 @@ public enum ApiError {
     USER_NOT_FOUND(HttpStatus.BAD_REQUEST, "User not found: %s"),
     CANNOT_DELETE_ADMIN(HttpStatus.FORBIDDEN, "Admin user cannot be deleted"),
     UNAUTHORIZED(HttpStatus.FORBIDDEN, "%s"),
+    BAD_REQUEST(HttpStatus.BAD_REQUEST, "%s"),
+    INTERNAL_SERVER_ERROR(HttpStatus.INTERNAL_SERVER_ERROR, "%s"),
     PASSWORD_INCORRECT(HttpStatus.BAD_REQUEST, "Incorrect current password"),
     PASSWORD_TOO_SHORT(HttpStatus.BAD_REQUEST, "Password must be at least 6 characters long"),
     PASSWORD_SAME_AS_CURRENT(HttpStatus.BAD_REQUEST, "New password cannot be the same as the current password"),

booklore-api/src/main/java/com/adityachandel/booklore/mapper/BookLoreUserMapper.java

@@ -23,6 +23,7 @@ default BookLoreUser.UserPermissions mapPermissions(UserPermissionsEntity permis
         dto.setCanDownload(permissions.isPermissionDownload());
         dto.setCanManipulateLibrary(permissions.isPermissionManipulateLibrary());
         dto.setCanEditMetadata(permissions.isPermissionEditMetadata());
+        dto.setCanEmailBook(permissions.isPermissionEmailBook());
         return dto;
     }
 }

booklore-api/src/main/java/com/adityachandel/booklore/mapper/EmailProviderMapper.java

@@ -0,0 +1,16 @@
+package com.adityachandel.booklore.mapper;
+
+import com.adityachandel.booklore.model.dto.EmailProvider;
+import com.adityachandel.booklore.model.dto.request.CreateEmailProviderRequest;
+import com.adityachandel.booklore.model.entity.EmailProviderEntity;
+import org.mapstruct.Mapper;
+import org.mapstruct.MappingTarget;
+
+@Mapper(componentModel = "spring")
+public interface EmailProviderMapper {
+
+    EmailProvider toDTO(EmailProviderEntity emailProviderEntity);
+    EmailProviderEntity toEntity(EmailProvider emailProvider);
+    EmailProviderEntity toEntity(CreateEmailProviderRequest createRequest);
+    void updateEntityFromRequest(CreateEmailProviderRequest request, @MappingTarget EmailProviderEntity entity);
+}