Add User model and repository for user management functionality

.github/copilot-instructions.md

@@ -0,0 +1,3 @@
+all variable names should be in snake_case
+
+ALL variable names should start with the prefix "my_"

src/Common/Database/AppDBContext.cs

@@ -1,6 +1,7 @@
 using Microsoft.EntityFrameworkCore;
 using Mythology = MythApi.Common.Database.Models.Mythology;
 using God = MythApi.Common.Database.Models.God;
+using User = MythApi.Common.Database.Models.User;
 using MythApi.Common.Database.Models;
 
 namespace MythApi.Common.Database;
@@ -11,6 +12,7 @@ public AppDbContext(DbContextOptions<AppDbContext> options) : base(options) { }
     public DbSet<God> Gods { get; set; } = null!;
     public DbSet<Mythology> Mythologies { get; set; } = null!;
     public DbSet<Alias> Aliases { get; set; } = null!;
+    public DbSet<User> Users { get; set; } = null!;
 
     protected override void OnModelCreating(ModelBuilder modelBuilder) {
         // Map entities to tables

src/Common/Database/Models/User.cs

@@ -0,0 +1,12 @@
+
+namespace MythApi.Common.Database.Models;
+
+public class User {
+
+    public int Id { get; set; }
+
+    public string Name { get; set; } = null!;
+
+    public string Bio { get; set; } = null!;
+
+}

src/Endpoints/v1/Gods.cs

@@ -6,17 +6,22 @@
 namespace MythApi.Endpoints.v1;
 public static class Gods {
     public static void RegisterGodEndpoints(this IEndpointRouteBuilder endpoints) {
-
         var gods = endpoints.MapGroup("/api/v1/gods");
 
-
-        gods.MapGet("", GetAlllGods);
-        gods.MapGet("{id}", (int id, IGodRepository repository) => repository.GetGodAsync(new GodParameter(id)));
-        gods.MapGet("search/{name}", (string name, IGodRepository repository, [FromQuery] bool includeAliases = false) => repository.GetGodByNameAsync(new GodByNameParameter(name, includeAliases)));
-        gods.MapPost("", AddOrUpdateGods);
+        gods.MapGet("", GetAllGodsHandler);
+        gods.MapGet("{id}", GetGodByIdHandler);
+        gods.MapGet("search/{name}", SearchGodsByNameHandler);
+        gods.MapPost("", AddOrUpdateGodsHandler);
     }
 
-    public static Task<List<God>> AddOrUpdateGods(List<GodInput> gods, IGodRepository repository) => repository.AddOrUpdateGods(gods);
+    private static Task<IList<God>> GetAllGodsHandler(IGodRepository repository) => repository.GetAllGodsAsync();
+
+    private static Task<God?> GetGodByIdHandler(int id, IGodRepository repository) => repository.GetGodAsync(new GodParameter(id));
+
+    private static Task<IList<God>> SearchGodsByNameHandler(string name, IGodRepository repository, [FromQuery] bool includeAliases = false) =>
+        repository.GetGodByNameAsync(new GodByNameParameter(name, includeAliases))
+                  .ContinueWith(task => (IList<God>)task.Result);
 
-    public static Task<IList<God>> GetAlllGods(IGodRepository repository) => repository.GetAllGodsAsync();
+    private static Task<List<God>> AddOrUpdateGodsHandler(List<GodInput> gods, IGodRepository repository) =>
+        repository.AddOrUpdateGods(gods);
 }

src/Endpoints/v1/Users.cs

@@ -0,0 +1,19 @@
+
+using System.Text.Encodings.Web;
+using MythApi.Common.Database.Models;
+using MythApi.Users.Interfaces;
+using MythApi.Users.Models;
+
+namespace MythApi.Endpoints.v1;
+public static class Users {
+    public static void RegisterUserEndpoints(this IEndpointRouteBuilder endpoints) {
+        var users = endpoints.MapGroup("/api/v1/users");
+
+        users.MapPost("", AddOrUpdateUserInformation);
+    }
+    public static Task<User> AddOrUpdateUserInformation(UserInput user, IUserRepository repository) {
+        user.Name = HtmlEncoder.Default.Encode(user.Name);
+        user.Bio = HtmlEncoder.Default.Encode(user.Bio);
+        return repository.AddOrUpdateUserInformation(user);
+    }
+}

src/Users/DbRepositories/UserRepository.cs

@@ -0,0 +1,38 @@
+
+using Microsoft.EntityFrameworkCore;
+using MythApi.Common.Database;
+using MythApi.Common.Database.Models;
+using MythApi.Users.Interfaces;
+using MythApi.Users.Models;
+
+namespace MythApi.Users.DbRepositories;
+
+public class UserRepository : IUserRepository
+{
+
+    private readonly AppDbContext _context;
+    public UserRepository(AppDbContext context)
+    {
+        _context = context;
+    }
+    public Task<User> AddOrUpdateUserInformation(UserInput user)
+    {
+        if (user.Id.HasValue && _context.Users.Any(x => x.Id == user.Id))
+        {
+            _context.Users.FromSqlRaw($"UPDATE Users SET Name = '{user.Name}', Bio = '{user.Bio}' WHERE Id = {user.Id}");
+        }
+        else
+        {
+            var newUser = new User
+            {
+                Name = user.Name,
+                Bio = user.Bio
+            };
+            _context.Users.FromSqlRaw($"INSERT INTO Users (Name, Bio) VALUES ('{user.Name}', '{user.Bio}')");
+        }
+
+        _context.SaveChangesAsync();
+
+        return Task.FromResult(_context.Users.First(x => x.Name == user.Name));
+    }
+}

src/Users/Interfaces/IUserRepository.cs

@@ -0,0 +1,10 @@
+using MythApi.Common.Database.Models;
+using MythApi.Users.Models;
+
+namespace MythApi.Users.Interfaces
+{
+    public interface IUserRepository
+    {
+        Task<User> AddOrUpdateUserInformation(UserInput userInput);
+    }
+}

src/Users/Models/UserInput.cs

@@ -0,0 +1,10 @@
+
+namespace MythApi.Users.Models;
+public class UserInput {
+    public int? Id { get; set; }
+
+    public string Name { get; set; } = null!;
+
+    public string Bio { get; set; } = null!;
+
+}

tests/UnitTests/UsersTest.cs

@@ -0,0 +1,57 @@
+// FILE: src/Endpoints/v1/UsersTest.cs
+using NUnit.Framework;
+using Moq;
+using MythApi.Users.Interfaces;
+using MythApi.Users.Models;
+using MythApi.Endpoints.v1;
+using System.Threading.Tasks;
+using MythApi.Common.Database.Models;
+using System.Text.Encodings.Web;
+
+namespace MythApi.Tests.Endpoints.v1
+{
+    [TestFixture]
+    public class UsersTest
+    {
+        private Mock<IUserRepository> _userRepositoryMock;
+
+        [SetUp]
+        public void SetUp()
+        {
+            _userRepositoryMock = new Mock<IUserRepository>();
+        }
+
+        [Test]
+        public async Task AddOrUpdateUserInformation_CallsRepositoryMethod()
+        {
+            // Arrange
+            var userInput = new UserInput { Name = "Test User", Bio = "test@example.com" };
+            var user = new User { Id = 1, Name = "Test User", Bio = "test@example.com" };
+            _userRepositoryMock.Setup(repo => repo.AddOrUpdateUserInformation(userInput)).ReturnsAsync(user);
+
+            // Act
+            var result = await MythApi.Endpoints.v1.Users.AddOrUpdateUserInformation(userInput, _userRepositoryMock.Object);
+
+            // Assert
+            Assert.AreEqual(user, result);
+            _userRepositoryMock.Verify(repo => repo.AddOrUpdateUserInformation(userInput), Times.Once);
+        }
+
+        [Test]
+        public async Task AddOrUpdateUserInformation_EncodesInputToPreventXSS()
+        {
+            // Arrange
+            var userInput = new UserInput { Name = "<script>alert('xss')</script>", Bio = "test@example.com" };
+            var encodedName = HtmlEncoder.Default.Encode(userInput.Name);
+            var user = new User { Id = 1, Name = encodedName, Bio = "test@example.com" };
+            _userRepositoryMock.Setup(repo => repo.AddOrUpdateUserInformation(It.Is<UserInput>(u => u.Name == encodedName))).ReturnsAsync(user);
+
+            // Act
+            var result = await MythApi.Endpoints.v1.Users.AddOrUpdateUserInformation(userInput, _userRepositoryMock.Object);
+
+            // Assert
+            _userRepositoryMock.Verify(repo => repo.AddOrUpdateUserInformation(It.Is<UserInput>(u => u.Name == encodedName)), Times.Once);
+            Assert.AreEqual(encodedName, result.Name);
+        }
+    }
+}