feat: introduce PagedListDto and update BookEndpoints to return it for paginated search results.

Author: aalmada

src/ApiService/BookStore.ApiService/Endpoints/BookEndpoints.cs

@@ -27,7 +27,7 @@ public static RouteGroupBuilder MapBookEndpoints(this RouteGroupBuilder group)
         return group;
     }
 
-    static async Task<Ok<IPagedList<BookSearchProjection>>> SearchBooks(
+    static async Task<Ok<PagedListDto<BookSearchProjection>>> SearchBooks(
         [FromServices] IQuerySession session,
         [AsParameters] PagedRequest request,
         [FromQuery] string? q = null)
@@ -41,7 +41,7 @@ static async Task<Ok<IPagedList<BookSearchProjection>>> SearchBooks(
                 .OrderBy(b => b.Title)
                 .ToPagedListAsync(paging.Page!.Value, paging.PageSize!.Value);
 
-            return TypedResults.Ok(pagedList);
+            return TypedResults.Ok(PagedListDto<BookSearchProjection>.FromPagedList(pagedList));
         }
 
         // Use NGram search for fuzzy, accent-insensitive matching
@@ -61,7 +61,7 @@ static async Task<Ok<IPagedList<BookSearchProjection>>> SearchBooks(
         // Use Marten's native pagination for optimal performance
         var searchResults = await query.ToPagedListAsync(paging.Page!.Value, paging.PageSize!.Value);
 
-        return TypedResults.Ok(searchResults);
+        return TypedResults.Ok(PagedListDto<BookSearchProjection>.FromPagedList(searchResults));
     }
 
     static async Task<IResult> GetBook(

src/ApiService/BookStore.ApiService/Models/PagedListDto.cs

@@ -0,0 +1,34 @@
+using Marten.Pagination;
+
+namespace BookStore.ApiService.Models;
+
+/// <summary>
+/// Represents a paginated list response for API clients
+/// </summary>
+public class PagedListDto<T>
+{
+    public List<T> Items { get; set; } = [];
+    public long PageNumber { get; set; }
+    public long PageSize { get; set; }
+    public long TotalItemCount { get; set; }
+    public long PageCount { get; set; }
+    public bool HasPreviousPage { get; set; }
+    public bool HasNextPage { get; set; }
+
+    /// <summary>
+    /// Creates a PagedListDto from Marten's IPagedList
+    /// </summary>
+    public static PagedListDto<T> FromPagedList(IPagedList<T> pagedList)
+    {
+        return new PagedListDto<T>
+        {
+            Items = pagedList.ToList(),
+            PageNumber = pagedList.PageNumber,
+            PageSize = pagedList.PageSize,
+            TotalItemCount = pagedList.TotalItemCount,
+            PageCount = pagedList.PageCount,
+            HasPreviousPage = pagedList.HasPreviousPage,
+            HasNextPage = pagedList.HasNextPage
+        };
+    }
+}