using DigitalData.Core.Exceptions; using EnvelopeGenerator.Application.Common.Dto.EnvelopeReceiver; using EnvelopeGenerator.Application.Common.Interfaces.Services; using EnvelopeGenerator.Application.Common.Interfaces.Services.Notification; using EnvelopeGenerator.Application.EnvelopeReceivers.Queries; using EnvelopeGenerator.Domain.Constants; using EnvelopeGenerator.Domain.Exceptions; using MediatR; namespace EnvelopeGenerator.Application.EnvelopeReceivers.Commands; /// /// /// /// public record SendAccessCodeCommand(string Key) : IRequest { } /// /// Business result of an access-code request. /// public enum SendAccessCodeResult { /// /// Access code sent successfully. HTTP: 200 OK. /// Sent, /// /// Receiver has already signed this envelope; requesting a code is no longer applicable. HTTP: 409 Conflict. /// AlreadySigned, /// /// Envelope does not require an access code. HTTP: 200 OK (or 204 No Content). /// NoAccessCodeRequired, /// /// Access code was already requested and the request limit/rule blocks another send. HTTP: 429 Too Many Requests. /// RequestLimitExceeded } /// /// /// public class SendAccessCodeCommandHandler(IMediator Sender, IEnvelopeHistoryService HistoryService, IEnvelopeNotificationService NtfService) : IRequestHandler { /// /// /// /// /// /// public async Task Handle(SendAccessCodeCommand request, CancellationToken cancel) { // read envelope receiver var ers = (await Sender.Send(new ReadEnvelopeReceiverQuery { Key = request.Key, }, cancel)); if (ers.SingleOrDefault() is not EnvelopeReceiverDto er || er.Envelope is null || er.Receiver is null) throw new NotFoundException($"Envelope receiver with key '{request.Key}' not found."); if (!er.Envelope.UseAccessCode) return SendAccessCodeResult.NoAccessCodeRequired; var userReference = er.Receiver.EmailAddress; if (await HistoryService.IsSigned(er.EnvelopeId, userReference)) return SendAccessCodeResult.AlreadySigned; var accessCodeAlreadyRequested = await HistoryService.AccessCodeAlreadyRequested(er.EnvelopeId, userReference); if (accessCodeAlreadyRequested) return SendAccessCodeResult.RequestLimitExceeded; var historyResult = await HistoryService.RecordAsync(er.EnvelopeId, userReference, EnvelopeStatus.AccessCodeRequested); if (historyResult.IsFailed) { throw new ApplicationException($"Failed to record AccessCodeRequested history for envelope {er.EnvelopeId} and receiver {userReference}."); } if(er.AccessCode is null) throw new DataIntegrityException($"Access code is null for envelope receiver with key '{request.Key}' although use-access-code is true."); await NtfService.Notify(er.Receiver.EmailAddress, new DocumentAccessCodeReceivedNotification() { DocumentAccessCode = er.AccessCode, DocumentTitle = er.Envelope.Title, NameReceiver = er.Name ?? string.Empty, IsReadAndConfirm = er.Envelope.Type == EnvelopeType.ReadAndConfirm, NameSender = er.Envelope.User!.Username, }, cancel); return SendAccessCodeResult.Sent; } }