Ability to see previous usernames via API

Refresh.Database/GameDatabaseContext.Registration.cs

@@ -8,6 +8,9 @@ namespace Refresh.Database;
 
 public partial class GameDatabaseContext // Registration
 {
+    private IQueryable<PreviousUsername> PreviousUsernamesIncluded => this.PreviousUsernames
+        .Include(p => p.User);
+
     public GameUser CreateUser(string username, string emailAddress, bool skipChecks = false)
     {
         if (!skipChecks)
@@ -110,6 +113,21 @@ public bool IsUsernameTaken(string username, GameUser? userToName = null)
 
         return false;
     }
+
+    public bool WasUsernamePreviouslyTaken(string username)
+    {
+        return this.PreviousUsernames.Any(u => u.Username == username);
+    }
+
+    public DatabaseList<PreviousUsername> GetPreviousUsernameRecordsForUsername(string username, int skip, int count)
+    {
+        return new(this.PreviousUsernamesIncluded.Where(u => u.Username == username), skip, count);
+    }
+
+    public DatabaseList<PreviousUsername> GetPreviousUsernameRecordsByUser(GameUser user, int skip, int count)
+    {
+        return new(this.PreviousUsernamesIncluded.Where(u => u.UserId == user.UserId), skip, count);
+    }
 
     public bool IsEmailTaken(string emailAddress)
     {

Refresh.Interfaces.APIv3/Endpoints/Admin/AdminUserApiEndpoints.cs

@@ -50,6 +50,31 @@ public ApiListResponse<ApiExtendedGameUserResponse> GetExtendedUsers(RequestCont
         return list;
     }
 
+    [ApiV3Endpoint("admin/previousUsernames/byName/{username}"), MinimumRole(GameUserRole.Moderator)]
+    [DocSummary("Gets all users (with extended information) who have once used the specified username.")]
+    [DocUsesPageData]
+    public ApiListResponse<ApiExtendedPreviousUsernameResponse> GetExtendedPreviousUsernamesByUsername(RequestContext context,
+        GameDatabaseContext database, IDataStore dataStore, DataContext dataContext, string username)
+    {
+        (int skip, int count) = context.GetPageData();
+        DatabaseList<PreviousUsername> previousNames = database.GetPreviousUsernameRecordsForUsername(username, skip, count);
+        return DatabaseListExtensions.FromOldList<ApiExtendedPreviousUsernameResponse, PreviousUsername>(previousNames, dataContext);
+    }
+
+    [ApiV3Endpoint("admin/previousUsernames/byUserUuid/{uuid}"), MinimumRole(GameUserRole.Moderator)]
+    [DocSummary("Gets all previous usernames which have once been used by the specified user.")]
+    [DocUsesPageData]
+    public ApiListResponse<ApiExtendedPreviousUsernameResponse> GetExtendedPreviousUsernamesByUser(RequestContext context,
+        GameDatabaseContext database, IDataStore dataStore, DataContext dataContext, string uuid)
+    {
+        GameUser? user = database.GetUserByUuid(uuid);
+        if (user == null) return ApiNotFoundError.UserMissingError;
+
+        (int skip, int count) = context.GetPageData();
+        DatabaseList<PreviousUsername> previousNames = database.GetPreviousUsernameRecordsByUser(user, skip, count);
+        return DatabaseListExtensions.FromOldList<ApiExtendedPreviousUsernameResponse, PreviousUsername>(previousNames, dataContext);
+    }
+
     [ApiV3Endpoint("admin/users/{idType}/{id}/resetPassword", HttpMethods.Put), MinimumRole(GameUserRole.Moderator)]
     [DocSummary("Resets a user's password by their UUID or username.")]
     [DocError(typeof(ApiNotFoundError), ApiNotFoundError.UserMissingErrorWhen)]

Refresh.Interfaces.APIv3/Endpoints/DataTypes/Response/Users/ApiExtendedPreviousUsernameResponse.cs

@@ -0,0 +1,23 @@
+using Refresh.Core.Types.Data;
+using Refresh.Database.Models.Users;
+
+namespace Refresh.Interfaces.APIv3.Endpoints.DataTypes.Response.Users;
+
+[JsonObject(NamingStrategyType = typeof(CamelCaseNamingStrategy))]
+public class ApiExtendedPreviousUsernameResponse : ApiPreviousUsernameResponse, IDataConvertableFrom<ApiExtendedPreviousUsernameResponse, PreviousUsername>
+{
+    public new static ApiExtendedPreviousUsernameResponse? FromOld(PreviousUsername? old, DataContext dataContext)
+    {
+        if (old == null) return null;
+
+        return new ApiExtendedPreviousUsernameResponse
+        {
+            Username = old.Username,
+            User = ApiExtendedGameUserResponse.FromOld(old.User, dataContext)!,
+            ReplacedAt = old.ReplacedAt,
+        };
+    }
+
+    public new static IEnumerable<ApiExtendedPreviousUsernameResponse> FromOldList(IEnumerable<PreviousUsername> oldList, DataContext dataContext) 
+        => oldList.Select(old => FromOld(old, dataContext)).ToList()!;
+}

Refresh.Interfaces.APIv3/Endpoints/DataTypes/Response/Users/ApiPreviousUsernameResponse.cs

@@ -0,0 +1,28 @@
+using Refresh.Core.Types.Data;
+using Refresh.Database.Models.Users;
+
+namespace Refresh.Interfaces.APIv3.Endpoints.DataTypes.Response.Users;
+
+[JsonObject(NamingStrategyType = typeof(CamelCaseNamingStrategy))]
+public class ApiPreviousUsernameResponse : IApiResponse, IDataConvertableFrom<ApiPreviousUsernameResponse, PreviousUsername>
+{
+    public required string Username { get; set; }
+    public required ApiGameUserResponse User { get; set; }
+    public required DateTimeOffset ReplacedAt { get; set; }
+
+    public static ApiPreviousUsernameResponse? FromOld(PreviousUsername? old, DataContext dataContext)
+    {
+        if (old == null) return null;
+
+        return new ApiPreviousUsernameResponse
+        {
+            Username = old.Username,
+            User = ApiGameUserResponse.FromOld(old.User, dataContext)!,
+            ReplacedAt = old.ReplacedAt,
+        };
+    }
+
+    public static IEnumerable<ApiPreviousUsernameResponse> FromOldList(IEnumerable<PreviousUsername> oldList, DataContext dataContext) 
+        => oldList.Select(old => FromOld(old, dataContext)).ToList()!;
+}
+

Refresh.Interfaces.APIv3/Endpoints/UserApiEndpoints.cs

@@ -15,6 +15,7 @@
 using Refresh.Database.Models.Authentication;
 using Refresh.Database.Models.Pins;
 using Refresh.Database.Models.Users;
+using Refresh.Interfaces.APIv3.Documentation.Attributes;
 using Refresh.Interfaces.APIv3.Documentation.Descriptions;
 using Refresh.Interfaces.APIv3.Endpoints.ApiTypes;
 using Refresh.Interfaces.APIv3.Endpoints.ApiTypes.Errors;
@@ -99,6 +100,18 @@ public ApiResponse<ApiExtendedGameUserResponse> GetMyUser(RequestContext context
         return ApiExtendedGameUserResponse.FromOld(user, dataContext);
     }
 
+    [ApiV3Endpoint("users/me/previousUsernames"), MinimumRole(GameUserRole.Moderator)]
+    [DocSummary("Gets all previous usernames which you have used.")]
+    [DocUsesPageData]
+    [RateLimitSettings(120, 35, 80, "me-api")] // TODO remove when we clean up rate-limit stats
+    public ApiListResponse<ApiExtendedPreviousUsernameResponse> GetMyPreviousUsernames(RequestContext context,
+        GameDatabaseContext database, IDataStore dataStore, DataContext dataContext, GameUser user)
+    {
+        (int skip, int count) = context.GetPageData();
+        DatabaseList<PreviousUsername> previousNames = database.GetPreviousUsernameRecordsByUser(user, skip, count);
+        return DatabaseListExtensions.FromOldList<ApiExtendedPreviousUsernameResponse, PreviousUsername>(previousNames, dataContext);
+    }
+
     [ApiV3Endpoint("users/me", HttpMethods.Patch)]
     [DocSummary("Updates your profile with the given data")]
     [RateLimitSettings(UserModificationEndpointLimits.TimeoutDuration, UserModificationEndpointLimits.ApiRequestAmount,