feat: introduce shared DTOs and global usings across projects

Author: aalmada

BookStore.slnx

@@ -13,4 +13,16 @@
     <Project Path="src/BookStore.AppHost/BookStore.AppHost.csproj" />
     <Project Path="src/BookStore.ServiceDefaults/BookStore.ServiceDefaults.csproj" />
   </Folder>
+  <Folder Name="/src/ApiService/">
+    <Project Path="src/ApiService/BookStore.ApiService.Analyzers/BookStore.ApiService.Analyzers.csproj" />
+    <Project Path="src/ApiService/BookStore.ApiService.Tests/BookStore.ApiService.Tests.csproj" />
+    <Project Path="src/ApiService/BookStore.ApiService/BookStore.ApiService.csproj" />
+  </Folder>
+  <Folder Name="/src/Shared/">
+    <Project Path="src/Shared/BookStore.Shared.Tests/BookStore.Shared.Tests.csproj" />
+    <Project Path="src/Shared/BookStore.Shared/BookStore.Shared.csproj" />
+  </Folder>
+  <Folder Name="/src/Web/">
+    <Project Path="src/Web/BookStore.Web/BookStore.Web.csproj" />
+  </Folder>
 </Solution>

src/ApiService/BookStore.ApiService.Tests/GlobalUsings.cs

@@ -0,0 +1 @@
+global using BookStore.Shared.Models;

src/ApiService/BookStore.ApiService/BookStore.ApiService.csproj

@@ -37,6 +37,7 @@
 
   <ItemGroup>
     <ProjectReference Include="..\BookStore.ApiService.Analyzers\BookStore.ApiService.Analyzers.csproj" OutputItemType="Analyzer" ReferenceOutputAssembly="false" />
+    <ProjectReference Include="..\..\Shared\BookStore.Shared\BookStore.Shared.csproj" />
   </ItemGroup>
 
 </Project>

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

@@ -29,7 +29,7 @@ public static RouteGroupBuilder MapBookEndpoints(this RouteGroupBuilder group)
         return group;
     }
 
-    static async Task<Ok<PagedListDto<Models.BookDto>>> SearchBooks(
+    static async Task<Ok<PagedListDto<BookDto>>> SearchBooks(
         [FromServices] IQuerySession session,
         [FromServices] IOptions<PaginationOptions> paginationOptions,
         [AsParameters] PagedRequest request,
@@ -79,7 +79,7 @@ public static RouteGroupBuilder MapBookEndpoints(this RouteGroupBuilder group)
         }
 
         // Map to DTOs with localized categories, descriptions, and biographies
-        var bookDtos = pagedList.Select(book => new Models.BookDto(
+        var bookDtos = pagedList.Select(book => new BookDto(
             book.Id,
             book.Title,
             book.Isbn,
@@ -89,23 +89,23 @@ public static RouteGroupBuilder MapBookEndpoints(this RouteGroupBuilder group)
             book.PublicationDate,
             Helpers.BookHelpers.IsPreRelease(book.PublicationDate),
             book.PublisherId.HasValue && publishers.TryGetValue(book.PublisherId.Value, out var pub)
-                ? new Models.PublisherDto(pub.Id, pub.Name)
+                ? new PublisherDto(pub.Id, pub.Name)
                 : null,
             [.. book.AuthorIds
                 .Select(id => authors.TryGetValue(id, out var author)
-                    ? new Models.AuthorDto(author.Id, author.Name, LocalizeBiography(author, language))
+                    ? new AuthorDto(author.Id, author.Name, LocalizeBiography(author, language))
                     : null)
                 .Where(a => a != null)
-                .Cast<Models.AuthorDto>()],
+                .Cast<AuthorDto>()],
             [.. book.CategoryIds
                 .Select(id => categories.TryGetValue(id, out var cat)
                     ? LocalizeCategory(cat, language)
                     : null)
                 .Where(c => c != null)
-                .Cast<Models.CategoryDto>()]
+                .Cast<CategoryDto>()]
         )).ToList();
 
-        return TypedResults.Ok(new PagedListDto<Models.BookDto>(
+        return TypedResults.Ok(new PagedListDto<BookDto>(
             bookDtos,
             pagedList.PageNumber,
             pagedList.PageSize,
@@ -156,7 +156,7 @@ static async Task<IResult> GetBook(
         }
 
         // Map to DTO with localized categories, description, and biographies
-        var bookDto = new Models.BookDto(
+        var bookDto = new BookDto(
             book.Id,
             book.Title,
             book.Isbn,
@@ -166,31 +166,31 @@ static async Task<IResult> GetBook(
             book.PublicationDate,
             Helpers.BookHelpers.IsPreRelease(book.PublicationDate),
             book.PublisherId.HasValue && publishers.TryGetValue(book.PublisherId.Value, out var pub)
-                ? new Models.PublisherDto(pub.Id, pub.Name)
+                ? new PublisherDto(pub.Id, pub.Name)
                 : null,
             [.. book.AuthorIds
                 .Select(id => authors.TryGetValue(id, out var author)
-                    ? new Models.AuthorDto(author.Id, author.Name, LocalizeBiography(author, language))
+                    ? new AuthorDto(author.Id, author.Name, LocalizeBiography(author, language))
                     : null)
                 .Where(a => a != null)
-                .Cast<Models.AuthorDto>()],
+                .Cast<AuthorDto>()],
             [.. book.CategoryIds
                 .Select(catId => categories.TryGetValue(catId, out var cat)
                     ? LocalizeCategory(cat, language)
                     : null)
                 .Where(c => c != null)
-                .Cast<Models.CategoryDto>()]);
+                .Cast<CategoryDto>()]);
 
         return TypedResults.Ok(bookDto);
     }
 
     // Helper method for category localization with fallback strategy
-    static Models.CategoryDto LocalizeCategory(CategoryProjection category, string language)
+    static CategoryDto LocalizeCategory(CategoryProjection category, string language)
     {
         // Try full culture code first (e.g., "pt-PT")
         if (category.Translations.TryGetValue(language, out var localized))
         {
-            return new Models.CategoryDto(category.Id, localized.Name);
+            return new CategoryDto(category.Id, localized.Name);
         }
 
         // Fallback to two-letter ISO language code (e.g., "pt" from "pt-PT")
@@ -201,7 +201,7 @@ static Models.CategoryDto LocalizeCategory(CategoryProjection category, string l
 
             if (category.Translations.TryGetValue(twoLetterCode, out var twoLetterLocalized))
             {
-                return new Models.CategoryDto(category.Id, twoLetterLocalized.Name);
+                return new CategoryDto(category.Id, twoLetterLocalized.Name);
             }
         }
         catch (System.Globalization.CultureNotFoundException)
@@ -212,12 +212,12 @@ static Models.CategoryDto LocalizeCategory(CategoryProjection category, string l
         // Fallback to English
         if (category.Translations.TryGetValue("en", out var englishName))
         {
-            return new Models.CategoryDto(category.Id, englishName.Name);
+            return new CategoryDto(category.Id, englishName.Name);
         }
 
         // Last resort: use first available localization
         var firstName = category.Translations.Values.FirstOrDefault();
-        return new Models.CategoryDto(category.Id, firstName?.Name ?? "Unknown");
+        return new CategoryDto(category.Id, firstName?.Name ?? "Unknown");
     }
 
     // Helper method for book description localization with fallback strategy

src/ApiService/BookStore.ApiService/GlobalUsings.cs

@@ -0,0 +1 @@
+global using BookStore.Shared.Models;

src/ApiService/BookStore.ApiService/Infrastructure/Extensions/JsonConfigurationExtensions.cs

@@ -1,4 +1,4 @@
-using BookStore.ApiService.Infrastructure.Json;
+using BookStore.Shared.Infrastructure.Json;
 
 namespace BookStore.ApiService.Infrastructure.Extensions;
 

src/ApiService/BookStore.ApiService/Infrastructure/Extensions/MartenConfigurationExtensions.cs

@@ -6,6 +6,7 @@
 using Marten.Events.Projections;
 using Weasel.Core;
 using Wolverine.Marten;
+using BookStore.Shared.Infrastructure.Json;
 
 namespace BookStore.ApiService.Infrastructure.Extensions;
 
@@ -60,7 +61,7 @@ static void ConfigureJsonSerialization(StoreOptions options)
             Casing.CamelCase,
             configure: settings =>
                 // Add custom converter for PartialDate to handle nullable values properly
-                settings.Converters.Add(new Json.PartialDateJsonConverter()));
+                settings.Converters.Add(new PartialDateJsonConverter()));
 
         // Enable NGram search with unaccent for multilingual text search
         // This automatically enables pg_trgm and unaccent extensions

src/ApiService/BookStore.ApiService/Infrastructure/Extensions/PagedListExtensions.cs

@@ -0,0 +1,21 @@
+using BookStore.Shared.Models;
+using Marten.Pagination;
+
+namespace BookStore.ApiService.Infrastructure.Extensions;
+
+public static class PagedListExtensions
+{
+    /// <summary>
+    /// Creates a PagedListDto from Marten's IPagedList
+    /// </summary>
+    public static PagedListDto<T> ToPagedListDto<T>(this IPagedList<T> pagedList) => new()
+    {
+        Items = [.. pagedList],
+        PageNumber = pagedList.PageNumber,
+        PageSize = pagedList.PageSize,
+        TotalItemCount = pagedList.TotalItemCount,
+        PageCount = pagedList.PageCount,
+        HasPreviousPage = pagedList.HasPreviousPage,
+        HasNextPage = pagedList.HasNextPage
+    };
+}