feat(controller): add endpoint to retrieve last used receiver name by email

- Implemented `Get` endpoint in `EnvelopeReceiverController` to fetch the last used receiver's name by email.
- Added handling for successful and failed responses, including proper status codes and logging.

EnvelopeGenerator.Application/Contracts/IEnvelopeReceiverService.cs

@@ -25,5 +25,7 @@ namespace EnvelopeGenerator.Application.Contracts
         Task<DataResult<bool>> IsExisting(string envelopeReceiverId);
 
         Task<DataResult<IEnumerable<EnvelopeReceiverDto>>> ReadByUsernameAsync(string username, int? min_status = null, int? max_status = null, params int[] ignore_statuses);
+
+        Task<DataResult<string?>> ReadLastUsedReceiverNameByMail(string mail);
     }
 }

EnvelopeGenerator.Application/EnvelopeGenerator.Application.csproj

@@ -14,7 +14,7 @@
     <PackageReference Include="AutoMapper" Version="13.0.1" />
     <PackageReference Include="DigitalData.Core.Abstractions" Version="1.0.1.1" />
     <PackageReference Include="DigitalData.Core.Application" Version="1.0.0" />
-    <PackageReference Include="DigitalData.Core.DTO" Version="1.0.0" />
+    <PackageReference Include="DigitalData.Core.DTO" Version="1.0.0.1" />
     <PackageReference Include="DigitalData.EmailProfilerDispatcher" Version="1.0.0" />
     <PackageReference Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="7.0.18" />
     <PackageReference Include="UserManager.Application" Version="1.0.0" />

EnvelopeGenerator.Application/Services/EnvelopeReceiverService.cs

@@ -122,5 +122,11 @@ namespace EnvelopeGenerator.Application.Services
             var dto_list = _mapper.MapOrThrow<IEnumerable<EnvelopeReceiverDto>>(er_list);
             return Result.Success(dto_list);
         }
+
+        public async Task<DataResult<string?>> ReadLastUsedReceiverNameByMail(string mail)
+        {
+            var er = await _repository.ReadLastByReceiver(mail);
+            return er is null ? Result.Fail<string?>().Notice(LogLevel.None, Flag.NotFound) : Result.Success(er.Name);
+        }        
     }
 }

EnvelopeGenerator.GeneratorAPI/Controllers/EnvelopeReceiverController.cs

@@ -6,6 +6,7 @@ using Microsoft.AspNetCore.Mvc;
 namespace EnvelopeGenerator.GeneratorAPI.Controllers
 {
     [Route("api/[controller]")]
+    [Authorize]
     [ApiController]
     public class EnvelopeReceiverController : ControllerBase
     {
@@ -18,7 +19,6 @@ namespace EnvelopeGenerator.GeneratorAPI.Controllers
             _erService = envelopeReceiverService;
         }
                 
-        [Authorize]
         [HttpGet]
         public async Task<IActionResult> GetEnvelopeReceiver([FromQuery] int? min_status = null, [FromQuery] int? max_status = null, [FromQuery] int[]? ignore_status = null)
         {
@@ -49,5 +49,28 @@ namespace EnvelopeGenerator.GeneratorAPI.Controllers
                 return new StatusCodeResult(StatusCodes.Status500InternalServerError);
             }
         }
+
+        [HttpGet("receiver-name/{mail}")]
+        public async Task<IActionResult> GetReceiverName([FromRoute] string mail)
+        {
+            try
+            {
+                return await _erService.ReadLastUsedReceiverNameByMail(mail).ThenAsync(
+                                Success: res => res is null ? Ok(string.Empty) : Ok(res),
+                                Fail: IActionResult (msg, ntc) =>
+                                {
+                                    if (ntc.HasFlag(Flag.NotFound))
+                                        return NotFound();
+
+                                    _logger.LogNotice(ntc);
+                                    return StatusCode(StatusCodes.Status500InternalServerError);
+                                });
+            }
+            catch(Exception ex)
+            {
+                _logger.LogError(ex, "{message}", ex.Message);
+                return StatusCode(StatusCodes.Status500InternalServerError);
+            }
+        }
     }
 }

EnvelopeGenerator.Infrastructure/Contracts/IEnvelopeReceiverRepository.cs

@@ -20,5 +20,7 @@ namespace EnvelopeGenerator.Infrastructure.Contracts
 		Task<string?> ReadAccessCodeByIdAsync(int envelopeId, int receiverId);
 
         Task<IEnumerable<EnvelopeReceiver>> ReadByUsernameAsync(string username, int? min_status = null, int? max_status = null, params int[] ignore_statuses);
+
+        Task<EnvelopeReceiver?> ReadLastByReceiver(string email);
     }
 }

EnvelopeGenerator.Infrastructure/Repositories/EnvlopeReceiverRepository.cs

@@ -1,5 +1,4 @@
 using DigitalData.Core.Infrastructure;
-using DigitalData.UserManager.Infrastructure.Repositories;
 using EnvelopeGenerator.Domain.Entities;
 using EnvelopeGenerator.Infrastructure.Contracts;
 using Microsoft.EntityFrameworkCore;
@@ -76,5 +75,10 @@ namespace EnvelopeGenerator.Infrastructure.Repositories
 
             return await query.Include(er => er.Envelope).Include(er => er.Receiver).ToListAsync();
         }
+
+        public async Task<EnvelopeReceiver?> ReadLastByReceiver(string email)
+        {
+            return await _dbSet.Where(er => er.Receiver!.EmailAddress == email).OrderBy(er => er.EnvelopeId).LastOrDefaultAsync();
+        }
     }
 }