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); }