feat: Introduce PartialDate type with JSON serialization

Author: aalmada

docs/getting-started.md

@@ -285,9 +285,9 @@ dotnet run --project src/BookStore.Tests/BookStore.Tests.csproj
 
 All tests use TUnit's fluent assertion syntax:
 ```csharp
-await Assert.That(result).IsNotNull();
-await Assert.That(actual).IsEqualTo(expected);
-await Assert.That(collection).Contains(item);
+_ = await Assert.That(result).IsNotNull();
+_ = await Assert.That(actual).IsEqualTo(expected);
+_ = await Assert.That(collection).Contains(item);
 ```
 
 > [!NOTE]

docs/testing-guide.md

@@ -67,7 +67,7 @@ public class BookHandlerTests
         var result = BookHandlers.Handle(command, session);
 
         // Assert
-        await Assert.That(result).IsNotNull();
+        _ = await Assert.That(result).IsNotNull();
         session.Events.Received(1).StartStream<BookAggregate>(...);
     }
 }
@@ -81,50 +81,50 @@ TUnit uses a fluent, async-first assertion syntax:
 
 ```csharp
 // Equality
-await Assert.That(actual).IsEqualTo(expected);
-await Assert.That(actual).IsNotEqualTo(unexpected);
+_ = await Assert.That(actual).IsEqualTo(expected);
+_ = await Assert.That(actual).IsNotEqualTo(unexpected);
 
 // Null checks
-await Assert.That(value).IsNotNull();
-await Assert.That(value).IsNull();
+_ = await Assert.That(value).IsNotNull();
+_ = await Assert.That(value).IsNull();
 
 // Boolean
-await Assert.That(condition).IsTrue();
-await Assert.That(condition).IsFalse();
+_ = await Assert.That(condition).IsTrue();
+_ = await Assert.That(condition).IsFalse();
 
 // Type checks
-await Assert.That(result).IsTypeOf<ExpectedType>();
-await Assert.That(result).IsNotTypeOf<UnexpectedType>();
+_ = await Assert.That(result).IsTypeOf<ExpectedType>();
+_ = await Assert.That(result).IsNotTypeOf<UnexpectedType>();
 ```
 
 ### Collection Assertions
 
 ```csharp
 // Contains
-await Assert.That(collection).Contains(item);
-await Assert.That(collection).DoesNotContain(item);
+_ = await Assert.That(collection).Contains(item);
+_ = await Assert.That(collection).DoesNotContain(item);
 
 // Empty/Not Empty
-await Assert.That(collection).IsEmpty();
-await Assert.That(collection).IsNotEmpty();
+_ = await Assert.That(collection).IsEmpty();
+_ = await Assert.That(collection).IsNotEmpty();
 
 // Count
-await Assert.That(collection).Count().IsEqualTo(3);
+_ = await Assert.That(collection).Count().IsEqualTo(3);
 ```
 
 ### String Assertions
 
 ```csharp
 // Contains
-await Assert.That(text).Contains("substring");
-await Assert.That(text).DoesNotContain("missing");
+_ = await Assert.That(text).Contains("substring");
+_ = await Assert.That(text).DoesNotContain("missing");
 
 // Starts/Ends With
-await Assert.That(text).StartsWith("prefix");
-await Assert.That(text).EndsWith("suffix");
+_ = await Assert.That(text).StartsWith("prefix");
+_ = await Assert.That(text).EndsWith("suffix");
 
 // Regex
-await Assert.That(text).Matches(@"pattern");
+_ = await Assert.That(text).Matches(@"pattern");
 ```
 
 ### Exception Assertions
@@ -163,7 +163,7 @@ public async Task UpdateBookHandler_WithMissingBook_ShouldReturnNotFound()
     var result = await BookHandlers.Handle(command, session, context);
 
     // Assert
-    await Assert.That(result).IsTypeOf<NotFound>();
+    _ = await Assert.That(result).IsTypeOf<NotFound>();
 }
 ```
 
@@ -180,7 +180,7 @@ public async Task DateTimeOffset_Should_Serialize_As_ISO8601_With_UTC()
     var testObject = new { Timestamp = new DateTimeOffset(2025, 12, 26, 17, 16, 9, 123, TimeSpan.Zero) };
     var json = JsonSerializer.Serialize(testObject, _options);
 
-    await Assert.That(json).Contains("\"timestamp\":\"2025-12-26T17:16:09.123+00:00\"");
+    _ = await Assert.That(json).Contains("\"timestamp\":\"2025-12-26T17:16:09.123+00:00\"");
 }
 ```
 
@@ -203,7 +203,7 @@ public async Task GetWebResourceRootReturnsOkStatusCode(CancellationToken cancel
     var httpClient = app.CreateHttpClient("webfrontend");
     var response = await httpClient.GetAsync("/", cancellationToken);
 
-    await Assert.That(response.StatusCode).IsEqualTo(HttpStatusCode.OK);
+    _ = await Assert.That(response.StatusCode).IsEqualTo(HttpStatusCode.OK);
 }
 ```
 
@@ -378,7 +378,7 @@ All TUnit assertions are async, so tests should be `async Task`:
 [Test]
 public async Task MyTest()  // ✓ Correct
 {
-    await Assert.That(result).IsNotNull();
+    _ = await Assert.That(result).IsNotNull();
 }
 
 [Test]
@@ -394,7 +394,7 @@ TUnit's fluent syntax is more readable:
 
 ```csharp
 // ✓ TUnit style
-await Assert.That(result).IsEqualTo(expected);
+_ = await Assert.That(result).IsEqualTo(expected);
 
 // ✗ Old xUnit style (don't use)
 Assert.Equal(expected, result);
@@ -442,7 +442,7 @@ public async Task Updates_configuration_file()
 {
     await ConfigurationManager.SetAsync("key", "value");
     var result = await ConfigurationManager.GetAsync("key");
-    await Assert.That(result).IsEqualTo("value");
+    _ = await Assert.That(result).IsEqualTo("value");
 }
 ```
 
@@ -547,7 +547,7 @@ public class BadTests
     public async Task Test1()
     {
         counter++;
-        await Assert.That(counter).IsEqualTo(1); // May fail if tests run in parallel
+        _ = await Assert.That(counter).IsEqualTo(1); // May fail if tests run in parallel
     }
 }
 
@@ -559,7 +559,7 @@ public class GoodTests
     {
         var counter = 0; // Local state
         counter++;
-        await Assert.That(counter).IsEqualTo(1);
+        _ = await Assert.That(counter).IsEqualTo(1);
     }
 }
 ```
@@ -582,7 +582,7 @@ public async Task CreateBook_PersistsBookToDatabase()
 {
     var book = await bookService.CreateBook(...);
     var retrieved = await bookService.GetBook(book.Id);
-    await Assert.That(retrieved).IsNotNull();
+    _ = await Assert.That(retrieved).IsNotNull();
 }
 ```
 
@@ -789,13 +789,13 @@ public void StoreResult()
 
 ```csharp
 // ✗ Bad: Expensive operation in assertion
-await Assert.That(await GetAllUsersFromDatabase())
+_ = await Assert.That(await GetAllUsersFromDatabase())
     .Count()
     .IsEqualTo(1000);
 
 // ✓ Good: Use efficient queries
 var userCount = await GetUserCountFromDatabase();
-await Assert.That(userCount).IsEqualTo(1000);
+_ = await Assert.That(userCount).IsEqualTo(1000);
 ```
 
 ### CI/CD Performance
@@ -853,10 +853,10 @@ If you're familiar with xUnit, here are the key differences:
 | `[Fact]` | `[Test]` |
 | `[Theory]` | `[Test]` |
 | `[InlineData(...)]` | `[Arguments(...)]` |
-| `Assert.Equal(expected, actual)` | `await Assert.That(actual).IsEqualTo(expected)` |
-| `Assert.NotNull(value)` | `await Assert.That(value).IsNotNull()` |
-| `Assert.True(condition)` | `await Assert.That(condition).IsTrue()` |
-| `Assert.Contains(item, collection)` | `await Assert.That(collection).Contains(item)` |
+| `Assert.Equal(expected, actual)` | `_ = await Assert.That(actual).IsEqualTo(expected)` |
+| `Assert.NotNull(value)` | `_ = await Assert.That(value).IsNotNull()` |
+| `Assert.True(condition)` | `_ = await Assert.That(condition).IsTrue()` |
+| `Assert.Contains(item, collection)` | `_ = await Assert.That(collection).Contains(item)` |
 
 See the [TUnit migration guide](https://tunit.dev/docs/migration/xunit/) for more details.
 

src/ApiService/BookStore.ApiService.Tests/ConfigurationValidationTests.cs

@@ -41,7 +41,7 @@ public async Task PaginationOptions_DefaultPageSizeNegative_FailsValidation()
         var results = ValidateModel(options);
 
         // Assert
-        using var scope = Assert.Multiple();
+        using var _ = Assert.Multiple();
         _ = await Assert.That(results).Count().IsEqualTo(1);
         _ = await Assert.That(results[0].ErrorMessage).Contains("DefaultPageSize must be between 1 and 1000");
     }
@@ -61,7 +61,7 @@ public async Task PaginationOptions_DefaultPageSizeZero_FailsValidation()
         var results = ValidateModel(options);
 
         // Assert
-        using var scope = Assert.Multiple();
+        using var _ = Assert.Multiple();
         _ = await Assert.That(results).Count().IsEqualTo(1);
         _ = await Assert.That(results[0].ErrorMessage).Contains("DefaultPageSize must be between 1 and 1000");
     }
@@ -81,7 +81,7 @@ public async Task PaginationOptions_DefaultPageSizeTooLarge_FailsValidation()
         var results = ValidateModel(options);
 
         // Assert
-        using var scope = Assert.Multiple();
+        using var _ = Assert.Multiple();
         _ = await Assert.That(results).Count().IsGreaterThanOrEqualTo(1);
         _ = await Assert.That(results.Any(r => r.ErrorMessage!.Contains("DefaultPageSize must be between 1 and 1000"))).IsTrue();
     }
@@ -101,7 +101,7 @@ public async Task PaginationOptions_MaxPageSizeNegative_FailsValidation()
         var results = ValidateModel(options);
 
         // Assert
-        using var scope = Assert.Multiple();
+        using var _ = Assert.Multiple();
         _ = await Assert.That(results).Count().IsEqualTo(1);
         _ = await Assert.That(results[0].ErrorMessage).Contains("MaxPageSize must be between 1 and 1000");
     }
@@ -121,7 +121,7 @@ public async Task PaginationOptions_MaxPageSizeZero_FailsValidation()
         var results = ValidateModel(options);
 
         // Assert
-        using var scope = Assert.Multiple();
+        using var _ = Assert.Multiple();
         _ = await Assert.That(results).Count().IsEqualTo(1);
         _ = await Assert.That(results[0].ErrorMessage).Contains("MaxPageSize must be between 1 and 1000");
     }
@@ -141,7 +141,7 @@ public async Task PaginationOptions_DefaultPageSizeGreaterThanMaxPageSize_FailsV
         var results = ValidateModel(options);
 
         // Assert
-        using var scope = Assert.Multiple();
+        using var _ = Assert.Multiple();
         _ = await Assert.That(results).Count().IsEqualTo(1);
         _ = await Assert.That(results[0].ErrorMessage).Contains("DefaultPageSize (100) cannot be greater than MaxPageSize (50)");
     }
@@ -179,7 +179,7 @@ public async Task LocalizationOptions_DefaultCultureEmpty_FailsValidation()
         var results = ValidateModel(options);
 
         // Assert
-        using var scope = Assert.Multiple();
+        using var _ = Assert.Multiple();
         _ = await Assert.That(results).IsNotEmpty();
         _ = await Assert.That(results.Any(r => r.ErrorMessage!.Contains("DefaultCulture"))).IsTrue();
     }
@@ -199,7 +199,7 @@ public async Task LocalizationOptions_SupportedCulturesEmpty_FailsValidation()
         var results = ValidateModel(options);
 
         // Assert
-        using var scope = Assert.Multiple();
+        using var _ = Assert.Multiple();
         _ = await Assert.That(results).IsNotEmpty();
         _ = await Assert.That(results.Any(r => r.ErrorMessage!.Contains("At least one supported culture"))).IsTrue();
     }
@@ -219,7 +219,7 @@ public async Task LocalizationOptions_DefaultCultureNotInSupportedCultures_Fails
         var results = ValidateModel(options);
 
         // Assert
-        using var scope = Assert.Multiple();
+        using var _ = Assert.Multiple();
         _ = await Assert.That(results).Count().IsEqualTo(1);
         _ = await Assert.That(results[0].ErrorMessage).Contains("DefaultCulture 'en-US' must be included in SupportedCultures");
     }

src/ApiService/BookStore.ApiService.Tests/CultureCacheTests.cs

@@ -80,7 +80,7 @@ public async Task IsValidCultureCode_CaseInsensitive_ReturnsTrue()
         var result2 = Infrastructure.CultureCache.IsValidCultureCode("PT");
 
         // Assert
-        using var scope = Assert.Multiple();
+        using var _ = Assert.Multiple();
         _ = await Assert.That(result1).IsTrue();
         _ = await Assert.That(result2).IsTrue();
     }
@@ -143,7 +143,7 @@ public async Task GetInvalidCodes_SomeInvalid_ReturnsInvalidOnes()
         var invalidCodes = Infrastructure.CultureCache.GetInvalidCodes(codes);
 
         // Assert
-        using var scope = Assert.Multiple();
+        using var _ = Assert.Multiple();
         _ = await Assert.That(invalidCodes).Count().IsEqualTo(2);
         _ = await Assert.That(invalidCodes).Contains("xx-XX");
         _ = await Assert.That(invalidCodes).Contains("invalid");

src/ApiService/BookStore.ApiService.Tests/Handlers/BookHandlerTests.cs

@@ -2,6 +2,7 @@
 using BookStore.ApiService.Commands;
 using BookStore.ApiService.Events;
 using BookStore.ApiService.Handlers.Books;
+using BookStore.ApiService.Models;
 using Marten;
 using Microsoft.AspNetCore.Http;
 using NSubstitute;
@@ -22,11 +23,13 @@ public async Task CreateBookHandler_ShouldStartStreamWithBookAddedEvent()
         var command = new CreateBook(
             "Clean Code",
             "978-0132350884",
-            "A Handbook of Agile Software Craftsmanship",
-            new DateOnly(2008, 8, 1),
-            Guid.CreateVersion7(),
-            [Guid.CreateVersion7()],
-            [Guid.CreateVersion7()]);
+            "en",
+            [], // Translations
+            new PartialDate(2008, 8, 1),
+            Guid.CreateVersion7(), // PublisherId
+            [Guid.CreateVersion7()], // AuthorIds
+            [Guid.CreateVersion7()]  // CategoryIds
+        );
 
         var session = Substitute.For<IDocumentSession>();
         _ = session.CorrelationId.Returns("test-correlation-id");
@@ -52,11 +55,13 @@ public async Task UpdateBookHandler_WithMissingBook_ShouldReturnNotFound()
             Guid.CreateVersion7(),
             "Updated Title",
             null,
-            null,
-            null,
-            null,
-            [],
-            []);
+            "en", // Language (non-nullable)
+            null, // Translations
+            null, // PartialDate
+            null, // PublisherId
+            [],   // AuthorIds
+            []    // CategoryIds
+        );
 
         var session = Substitute.For<IDocumentSession>();
         var context = new DefaultHttpContext();