feature(#20): this commit introduces support for assigning audiences to customers

Author: https-richardy

Applications/Backend/Source/HttpsRichardy.Federation.Application/Handlers/Client/AssignAudienceClientHandler.cs

@@ -0,0 +1,33 @@
+namespace HttpsRichardy.Federation.Application.Handlers.Client;
+
+public sealed class AssignAudienceClientHandler(IClientCollection clientCollection) :
+    IDispatchHandler<AssignClientAudienceScheme, Result<IReadOnlyCollection<string>>>
+{
+    public async Task<Result<IReadOnlyCollection<string>>> HandleAsync(
+        AssignClientAudienceScheme parameters, CancellationToken cancellation = default)
+    {
+        var filters = ClientFilters.WithSpecifications()
+            .WithIdentifier(parameters.Id)
+            .Build();
+
+        var clients = await clientCollection.GetClientsAsync(filters, cancellation);
+        var client = clients.FirstOrDefault();
+
+        if (client is null)
+        {
+            return Result<IReadOnlyCollection<string>>.Failure(ClientErrors.ClientDoesNotExist);
+        }
+
+        var audience = new Audience(parameters.Value);
+        if (client.Audiences.Any(current => current.Value == audience.Value))
+        {
+            return Result<IReadOnlyCollection<string>>.Failure(ClientErrors.ClientAlreadyHasAudience);
+        }
+
+        client.Audiences.Add(audience);
+
+        await clientCollection.UpdateAsync(client, cancellation);
+
+        return Result<IReadOnlyCollection<string>>.Success([.. client.Audiences.Select(current => current.Value)]);
+    }
+}

Applications/Backend/Source/HttpsRichardy.Federation.Application/Payloads/Client/AssignClientAudienceScheme.cs

@@ -0,0 +1,9 @@
+namespace HttpsRichardy.Federation.Application.Payloads.Client;
+
+public sealed record AssignClientAudienceScheme :
+    IDispatchable<Result<IReadOnlyCollection<string>>>
+{
+    [JsonIgnore]
+    public string Id { get; init; } = default!;
+    public string Value { get; init; } = default!;
+}

Applications/Backend/Source/HttpsRichardy.Federation.Domain/Aggregates/Client.cs

@@ -8,6 +8,7 @@ public sealed class Client : Aggregate
     public string RealmId { get; set; } = default!;
     public string ClientId { get; set; } = default!;
 
+    public ICollection<Audience> Audiences { get; set; } = [];
     public ICollection<Grant> Flows { get; set; } = [];
     public ICollection<RedirectUri> RedirectUris { get; set; } = [];
     public ICollection<Permission> Permissions { get; set; } = [];

Applications/Backend/Source/HttpsRichardy.Federation.Domain/Concepts/Audience.cs

@@ -0,0 +1,7 @@
+namespace HttpsRichardy.Federation.Domain.Concepts;
+
+public sealed record Audience(string Value) :
+    IValueObject<Audience>
+{
+    public string Value { get; init; } = Value;
+}

Applications/Backend/Source/HttpsRichardy.Federation.Domain/Errors/ClientErrors.cs

@@ -12,6 +12,11 @@ public static class ClientErrors
         Description: "The client already has the specified permission assigned."
     );
 
+    public static readonly Error ClientAlreadyHasAudience = new(
+        Code: "#ERROR-F4E2A",
+        Description: "The client already has the specified audience assigned."
+    );
+
     public static readonly Error PermissionNotAssigned = new(
         Code: "#ERROR-C2FB0",
         Description: "The client does not have the specified permission assigned."