Use wrapper class for get all api endpoints

To enable e.g. pagination in the future

src/WebApi/Cars/GetCars.cs

@@ -1,27 +1,46 @@
-using Microsoft.EntityFrameworkCore;
+using Microsoft.AspNetCore.Http.HttpResults;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.EntityFrameworkCore;
 using Vegasco.WebApi.Persistence;
 
 namespace Vegasco.WebApi.Cars;
 
 public static class GetCars
 {
-	public record Response(Guid Id, string Name);
+	public class ApiResponse
+	{
+		public IEnumerable<ResponseDto> Cars { get; set; } = [];
+	}
+	
+	public record ResponseDto(Guid Id, string Name);
+
+	public class Request
+	{
+		[FromQuery(Name = "page")] public int? Page { get; set; }
+		[FromQuery(Name = "pageSize")] public int? PageSize { get; set; }
+	}
 
 	public static RouteHandlerBuilder MapEndpoint(IEndpointRouteBuilder builder)
 	{
 		return builder
 			.MapGet("cars", Endpoint)
+			.WithDescription("Returns all cars")
 			.WithTags("Cars");
 	}
 
-	private static async Task<IResult> Endpoint(
+	private static async Task<Ok<ApiResponse>> Endpoint(
+		[AsParameters] Request request,
 		ApplicationDbContext dbContext,
 		CancellationToken cancellationToken)
 	{
-		var cars = await dbContext.Cars
+		List<ResponseDto> cars = await dbContext.Cars
-			.Select(x => new Response(x.Id.Value, x.Name))
+			.Select(x => new ResponseDto(x.Id.Value, x.Name))
 			.ToListAsync(cancellationToken);
 
-		return TypedResults.Ok(cars);
+		var response = new ApiResponse
+		{
+			Cars = cars
+		};
+		return TypedResults.Ok(response);
 	}
 }

src/WebApi/Consumptions/GetConsumptions.cs

@@ -1,27 +1,53 @@
-using Microsoft.EntityFrameworkCore;
+using Microsoft.AspNetCore.Http.HttpResults;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.EntityFrameworkCore;
 using Vegasco.WebApi.Persistence;
 
 namespace Vegasco.WebApi.Consumptions;
 
 public static class GetConsumptions
 {
-	public record Response(Guid Id, DateTimeOffset DateTime, double Distance, double Amount, bool IgnoreInCalculation, Guid CarId);
+    public class ApiResponse
+    {
+        public IEnumerable<ResponseDto> Consumptions { get; set; } = [];
+    }
+
+    public record ResponseDto(
+        Guid Id,
+        DateTimeOffset DateTime,
+        double Distance,
+        double Amount,
+        bool IgnoreInCalculation,
+        Guid CarId);
+
+    public class Request
+    {
+        [FromQuery(Name = "page")] public int? Page { get; set; }
+        [FromQuery(Name = "pageSize")] public int? PageSize { get; set; }
+    }
 
     public static RouteHandlerBuilder MapEndpoint(IEndpointRouteBuilder builder)
     {
         return builder
             .MapGet("consumptions", Endpoint)
+            .WithDescription("Returns all consumption entries")
             .WithTags("Consumptions");
     }
 
-	private static async Task<IResult> Endpoint(
+    private static async Task<Ok<ApiResponse>> Endpoint(
+        [AsParameters] Request request,
         ApplicationDbContext dbContext,
         CancellationToken cancellationToken)
     {
-		var consumptions = await dbContext.Consumptions
+        List<ResponseDto> consumptions = await dbContext.Consumptions
-			.Select(x => new Response(x.Id.Value, x.DateTime, x.Distance, x.Amount, x.IgnoreInCalculation, x.CarId.Value))
+            .Select(x =>
+                new ResponseDto(x.Id.Value, x.DateTime, x.Distance, x.Amount, x.IgnoreInCalculation, x.CarId.Value))
             .ToListAsync(cancellationToken);
 
-		return TypedResults.Ok(consumptions);
+        var apiResponse = new ApiResponse
+        {
+            Consumptions = consumptions
+        };
+        return TypedResults.Ok(apiResponse);
     }
 }

tests/WebApi.Tests.Integration/Cars/GetCarsTests.cs

@@ -23,12 +23,12 @@ public class GetCarsTests : IAsyncLifetime
 		// Arrange
 
 		// Act
-		var response = await _factory.HttpClient.GetAsync("v1/cars");
+		using HttpResponseMessage response = await _factory.HttpClient.GetAsync("v1/cars");
 
 		// Assert
 		response.StatusCode.Should().Be(HttpStatusCode.OK);
-		var cars = await response.Content.ReadFromJsonAsync<IEnumerable<GetCars.Response>>();
+		var apiResponse = await response.Content.ReadFromJsonAsync<GetCars.ApiResponse>();
-		cars.Should().BeEmpty();
+		apiResponse!.Cars.Should().BeEmpty();
 	}
 
 	[Fact]
@@ -40,8 +40,8 @@ public class GetCarsTests : IAsyncLifetime
 		const int numberOfCars = 5;
 		for (var i = 0; i < numberOfCars; i++)
 		{
-			var createCarRequest = _carFaker.CreateCarRequest();
+			CreateCar.Request createCarRequest = _carFaker.CreateCarRequest();
-			var createCarResponse = await _factory.HttpClient.PostAsJsonAsync("v1/cars", createCarRequest);
+			HttpResponseMessage createCarResponse = await _factory.HttpClient.PostAsJsonAsync("v1/cars", createCarRequest);
 			createCarResponse.EnsureSuccessStatusCode();
 
 			var createdCar = await createCarResponse.Content.ReadFromJsonAsync<CreateCar.Response>();
@@ -49,12 +49,12 @@ public class GetCarsTests : IAsyncLifetime
 		}
 
 		// Act
-		var response = await _factory.HttpClient.GetAsync("v1/cars");
+		using HttpResponseMessage response = await _factory.HttpClient.GetAsync("v1/cars");
 
 		// Assert
 		response.StatusCode.Should().Be(HttpStatusCode.OK);
-		var cars = await response.Content.ReadFromJsonAsync<IEnumerable<GetCars.Response>>();
+		var apiResponse = await response.Content.ReadFromJsonAsync<GetCars.ApiResponse>();
-		cars.Should().BeEquivalentTo(createdCars);
+		apiResponse!.Cars.Should().BeEquivalentTo(createdCars);
 	}
 
 	public Task InitializeAsync() => Task.CompletedTask;

tests/WebApi.Tests.Integration/Consumptions/GetConsumptionsTests.cs

@@ -42,8 +42,8 @@ public class GetConsumptionsTests : IAsyncLifetime
 
 		// Assert
 		response.StatusCode.Should().Be(HttpStatusCode.OK);
-		var consumptions = await response.Content.ReadFromJsonAsync<List<GetConsumptions.Response>>();
+		var apiResponse = await response.Content.ReadFromJsonAsync<GetConsumptions.ApiResponse>();
-		consumptions.Should().BeEquivalentTo(createdConsumptions);
+		apiResponse!.Consumptions.Should().BeEquivalentTo(createdConsumptions);
 	}
 
 	[Fact]
@@ -56,8 +56,8 @@ public class GetConsumptionsTests : IAsyncLifetime
 
 		// Assert
 		response.StatusCode.Should().Be(HttpStatusCode.OK);
-		var consumptions = await response.Content.ReadFromJsonAsync<List<GetConsumptions.Response>>();
+		var apiResponse = await response.Content.ReadFromJsonAsync<GetConsumptions.ApiResponse>();
-		consumptions.Should().BeEmpty();
+		apiResponse!.Consumptions.Should().BeEmpty();
 	}
 
 	private async Task<CreateConsumption.Response> CreateConsumptionAsync()