namespace EnvelopeGenerator.Application.Contracts
{
    public interface IEnvelopeReceiverCache
    {
        Task<string?> GetSmsCodeAsync(string envelopeReceiverId);

        /// <summary>
        /// Asynchronously stores an SMS verification code in the cache and returns the expiration date of the code.
        /// </summary>
        /// <param name="envelopeReceiverId">The unique identifier for the recipient of the envelope to associate with the SMS code.</param>
        /// <param name="code">The SMS verification code to be stored.</param>
        /// <returns>A task that represents the asynchronous operation. The task result contains the expiration date and time of the stored SMS code.</returns>
        Task<DateTime> SetSmsCodeAsync(string envelopeReceiverId, string code);

        Task<DateTime?> GetSmsCodeExpirationAsync(string envelopeReceiverId);
    }
}