feature(#22): this commit introduces a handler for rotating realm secrets to rotate the secrets of a specific realm, using the rotation service and validating the realm's existence.

Author: https-richardy

Applications/Backend/Source/HttpsRichardy.Federation.Application/Handlers/Secret/RotateRealmSecretsHandler.cs

@@ -0,0 +1,25 @@
+namespace HttpsRichardy.Federation.Application.Handlers.Secret;
+
+public sealed class RotateRealmSecretsHandler(ISecretRotationService rotationService, IRealmCollection realmCollection) :
+    IDispatchHandler<RotateRealmSecretsParameters, Result>
+{
+    public async Task<Result> HandleAsync(
+        RotateRealmSecretsParameters parameters, CancellationToken cancellation = default)
+    {
+        var realmFilters = RealmFilters.WithSpecifications()
+            .WithIdentifier(parameters.RealmId)
+            .Build();
+
+        var realms = await realmCollection.GetRealmsAsync(realmFilters, cancellation);
+        var realm = realms.FirstOrDefault();
+
+        if (realm is null)
+        {
+            return Result.Failure(RealmErrors.RealmDoesNotExist);
+        }
+
+        await rotationService.RotateSecretAsync(realm, cancellation);
+
+        return Result.Success();
+    }
+}

Applications/Backend/Source/HttpsRichardy.Federation.Application/Payloads/Secret/RotateRealmSecretsParameters.cs

@@ -0,0 +1,7 @@
+namespace HttpsRichardy.Federation.Application.Payloads.Secret;
+
+public sealed record RotateRealmSecretsParameters :
+    IDispatchable<Result>
+{
+    public string RealmId { get; init; } = default!;
+}