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; using Microsoft.Extensions.Caching.Memory; using Microsoft.Extensions.Options; namespace EnvelopeGenerator.Application.EnvelopeReceivers.Commands; /// /// /// /// public record SendAccessCodeCommand(string Key) : IRequest { internal bool MultipleRequestsAllowed { get; private set; } = false; /// /// /// /// public SendAccessCodeCommand AllowMultipleRequests(bool allow = true) { MultipleRequestsAllowed = allow; return this; } } /// /// 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, IOptions options, IMemoryCache Cache) : IRequestHandler { /// /// /// public readonly SendAccessCodeParams Options = options.Value; /// /// /// /// /// /// 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 && (!request.MultipleRequestsAllowed || await IsAccessCodeRequestsDisabled(request.Key, cancel))) return SendAccessCodeResult.RequestLimitExceeded; // create a history record if (!accessCodeAlreadyRequested) { 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); await DisableAccessCodeRequests(request.Key, cancel); return SendAccessCodeResult.Sent; } private static string DisableAccessCodeRequestsCacheKeyPrefix => "DisableAccessCodeRequests_"; /// /// /// /// /// /// private Task IsAccessCodeRequestsDisabled(string envelopeKey, CancellationToken cancellationToken = default) { bool hasCache = Cache.TryGetValue(DisableAccessCodeRequestsCacheKeyPrefix + envelopeKey, out var disabled); return Task.FromResult(hasCache && disabled); } /// /// /// /// /// /// private Task DisableAccessCodeRequests(string envelopeKey, CancellationToken cancellationToken = default) { Cache.Set(DisableAccessCodeRequestsCacheKeyPrefix + envelopeKey, true, Options.RepeatRequestBlockingPeriod); return Task.CompletedTask; } }