using Microsoft.AspNetCore.Http;
using SlpModularCms.Core.Hosting.Proxy;
using SlpModularCms.Modules.Contact.Data.Entities;
namespace SlpModularCms.Modules.Contact.Services;
///
/// Verifies a captcha token server-side. Implementations must fail open: when the provider
/// itself is unreachable they return true (and log without personal data), so real
/// visitors are never locked out by a provider outage.
///
public interface ICaptchaVerifier
{
Task VerifyAsync(string? captchaToken, CancellationToken cancellationToken);
}
/// Used while no captcha is configured: everything passes.
public sealed class NullCaptchaVerifier : ICaptchaVerifier
{
public Task VerifyAsync(string? captchaToken, CancellationToken cancellationToken) => Task.FromResult(true);
}
public enum ContactMailOutcome
{
/// No mail was attempted (no sender available yet); the message stays pending.
Skipped,
Sent,
Failed,
}
///
/// Sends the notification mail for a genuine message. Called after the message is stored; a
/// failure must never fail the request. The real implementation arrives with the mail unit.
///
public interface IContactMailSender
{
Task SendAsync(ContactMessage message, CancellationToken cancellationToken);
}
public sealed class NoOpContactMailSender : IContactMailSender
{
public Task SendAsync(ContactMessage message, CancellationToken cancellationToken)
=> Task.FromResult(ContactMailOutcome.Skipped);
}
///
/// The single place that decides which rate-limit bucket a request belongs to.
///
///
/// Every contact policy is partitioned per client, with the same key as the other policies of the
/// host (: the remote address as seen by the pipeline, the real
/// visitor once ForwardedHeaders:KnownProxies is configured). That setting is required on
/// every host that enables the contact routes: without it all visitors share the proxy's address,
/// i.e. one bucket for the whole site. The routes stay disabled by default
/// (Contact:Enabled=false) until that has been checked on the host.
///
public static class ContactRateLimitPartition
{
public static string KeyFor(HttpContext context) => ClientPartitionKey.For(context);
}