Add extra endpoint to add an alias

Directory.Build.props

@@ -19,7 +19,7 @@
   <PropertyGroup>
     <PasswordlessMajorVersion>1</PasswordlessMajorVersion>
     <PasswordlessMinorVersion>0</PasswordlessMinorVersion>
-    <PasswordlessPatchVersion>3</PasswordlessPatchVersion>
+    <PasswordlessPatchVersion>4</PasswordlessPatchVersion>
     <PasswordlessMajorMinorVersion>$(PasswordlessMajorVersion).$(PasswordlessMinorVersion)</PasswordlessMajorMinorVersion>
     <VersionPrefix>$(PasswordlessMajorMinorVersion).$(PasswordlessPatchVersion)</VersionPrefix>
   </PropertyGroup>
@@ -31,5 +31,4 @@
     -->
     <Using Remove="System.Net.Http" />
   </ItemGroup>
-
 </Project>

src/Passwordless/Helpers/PasswordlessSerializerContext.cs

@@ -7,7 +7,7 @@ namespace Passwordless.Helpers;
 [JsonSourceGenerationOptions(
     PropertyNamingPolicy = JsonKnownNamingPolicy.CamelCase,
     DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull)]
-[JsonSerializable(typeof(AddAliasRequest))]
+[JsonSerializable(typeof(SetAliasRequest))]
 [JsonSerializable(typeof(RegisterTokenResponse))]
 [JsonSerializable(typeof(RegisterOptions))]
 [JsonSerializable(typeof(VerifyTokenRequest))] // TODO: Use this with JsonContent.Create

src/Passwordless/IPasswordlessClient.cs

@@ -1,4 +1,4 @@
-using Passwordless.Models;
+using Passwordless.Models;
 
 namespace Passwordless;
 
@@ -8,12 +8,12 @@ namespace Passwordless;
 public interface IPasswordlessClient
 {
     /// <summary>
-    /// Adds one or more aliases to an existing user.
+    /// Sets one or more aliases to an existing user and removes existing aliases that are not included in the request.
     /// </summary>
     /// <param name="request"></param>
     /// <param name="cancellationToken"></param>
     /// <returns></returns>
-    Task AddAliasAsync(AddAliasRequest request, CancellationToken cancellationToken = default);
+    Task SetAliasAsync(SetAliasRequest request, CancellationToken cancellationToken = default);
 
     /// <summary>
     /// Creates a <see cref="RegisterTokenResponse" /> which will be used by your frontend to negotiate

src/Passwordless/Models/SetAliasRequest.cs

@@ -0,0 +1,51 @@
+namespace Passwordless.Models;
+
+public class SetAliasRequest
+{
+
+    /// <summary>
+    /// Sets a single alias for a given user, and removes any other aliases that may exist.
+    /// </summary>
+    /// <param name="userId"></param>
+    /// <param name="alias"></param>
+    /// <param name="hashing"></param>
+    public SetAliasRequest(string userId, string alias, bool hashing = true)
+        : this(userId, new HashSet<string> { alias }, hashing)
+    {
+    }
+
+    /// <summary>
+    /// Sets one or more aliases for a given user, and removes any other aliases that may exist.
+    /// </summary>
+    /// <param name="userId"></param>
+    /// <param name="aliases"></param>
+    /// <param name="hashing"></param>
+    /// <exception cref="ArgumentNullException"></exception>
+    public SetAliasRequest(string userId, HashSet<string> aliases, bool hashing = true)
+    {
+        UserId = userId ?? throw new ArgumentNullException(nameof(userId));
+        Hashing = hashing;
+
+        Aliases = aliases == null
+            ? new HashSet<string>()
+            : new HashSet<string>(aliases.Where(x => !string.IsNullOrWhiteSpace(x)));
+    }
+
+    public string UserId { get; }
+
+    public IReadOnlyCollection<string> Aliases { get; }
+
+    /// <summary>
+    /// If you want your aliases to be available in plain text, set the <see cref="bool"/> false.
+    /// </summary>
+    public bool Hashing { get; }
+
+    /// <summary>
+    /// Removes all aliases from a user.
+    /// </summary>
+    /// <param name="userId"></param>
+    public static SetAliasRequest Empty(string userId)
+    {
+        return new SetAliasRequest(userId, new HashSet<string>(), true);
+    }
+}

src/Passwordless/PasswordlessClient.cs

@@ -41,11 +41,11 @@ public PasswordlessClient(HttpClient client)
     }
 
     /// <inheritdoc/>
-    public async Task AddAliasAsync(AddAliasRequest request, CancellationToken cancellationToken)
+    public async Task SetAliasAsync(SetAliasRequest request, CancellationToken cancellationToken)
     {
         var res = await _client.PostAsJsonAsync("alias",
             request,
-            PasswordlessSerializerContext.Default.AddAliasRequest,
+            PasswordlessSerializerContext.Default.SetAliasRequest,
             cancellationToken);
         res.EnsureSuccessStatusCode();
     }