Atualiza versão e melhora tratamento de exceções

Esta atualização inclui melhorias na estrutura de tratamento de exceções e testes.

* Atualização de dependências
  - Alterado `SPPreview` de `-preview-4.3` para `-preview-4.4`.

* Melhoria no tratamento de exceções
  - Adicionadas duas sobrecargas do método `ToException` na classe `Problems`.
  - Modificadas as funções `EnsureSuccess` e `EnsureHasValue` para usar `ToException`.

* Adição de testes
  - Novos testes para verificar o comportamento do método `ToException` na classe `ProblemsTests`.

Author: eglauko

src/Directory.Build.props

@@ -10,7 +10,7 @@
 	</PropertyGroup>
 	<PropertyGroup>
 		<SPVer>1.0.0</SPVer>
-		<SPPreview>-preview-4.3</SPPreview>
+		<SPPreview>-preview-4.4</SPPreview>
 	</PropertyGroup>
 	<PropertyGroup>
 		<FluentValidationVer>12.0.0</FluentValidationVer>

src/RoyalCode.SmartProblems.Tests/Basics/ProblemsTests.cs

@@ -282,6 +282,56 @@ public void Problems_CopyTo_Must_ThrowArgumentException_When_LengthIsNotEnough()
         // Assert
         Assert.Throws<ArgumentException>(act);
     }
+
+    [Fact]
+    public void Problems_ToException()
+    {
+        // Arrange
+        Problems problems = [Problems.InvalidParameter("Invalid parameter 1"), Problems.InvalidParameter("Invalid parameter 2")];
+        
+        // Act
+        var exception = problems.ToException();
+        
+        // Assert
+        Assert.NotNull(exception);
+        Assert.IsType<InvalidOperationException>(exception);
+        Assert.Contains("Invalid parameter 1", exception.Message);
+        Assert.Contains("Invalid parameter 2", exception.Message);
+    }
+
+    [Fact]
+    public void Problems_ToException_WithMessagePattern()
+    {
+        // Arrange
+        Problems problems = [Problems.InvalidParameter("Invalid parameter 1"), Problems.InvalidParameter("Invalid parameter 2")];
+
+        // Act
+        var exception = problems.ToException("Custom message: {0}");
+
+        // Assert
+        Assert.NotNull(exception);
+        Assert.IsType<InvalidOperationException>(exception);
+        Assert.Contains("Custom message:", exception.Message);
+        Assert.Contains("Invalid parameter 1", exception.Message);
+        Assert.Contains("Invalid parameter 2", exception.Message);
+    }
+
+    [Fact]
+    public void Problems_ToException_WithMessagePattern_And_Separator()
+    {
+        // Arrange
+        Problems problems = [Problems.InvalidParameter("Invalid parameter 1"), Problems.InvalidParameter("Invalid parameter 2")];
+
+        // Act
+        var exception = problems.ToException("Custom message:\n - {0}", "\n - ");
+
+        // Assert
+        Assert.NotNull(exception);
+        Assert.IsType<InvalidOperationException>(exception);
+        Assert.Contains("Custom message:", exception.Message);
+        Assert.Contains("\n - Category: InvalidParameter, Details: Invalid parameter 1", exception.Message);
+        Assert.Contains("\n - Category: InvalidParameter, Details: Invalid parameter 2", exception.Message);
+    }
 }
 
 #region classes

src/RoyalCode.SmartProblems/Problems.cs

@@ -445,4 +445,31 @@ public Problem this[int index]
     }
 
     #endregion
+
+    /// <summary>
+    /// Creates an <see cref="InvalidOperationException"/> from the collection of problems.
+    /// The exception message will contain the details of all problems in the collection.
+    /// </summary>
+    /// <returns>A new instance of <see cref="InvalidOperationException"/>.</returns>
+    public InvalidOperationException ToException()
+    {
+        return new InvalidOperationException(string.Join("\n", this.Select(p => p.ToString())));
+    }
+
+    /// <summary>
+    /// Creates an <see cref="InvalidOperationException"/> from the collection of problems.
+    /// The exception message will be formatted using the provided pattern,
+    /// where the first argument is the details of all problems in the collection.
+    /// </summary>
+    /// <remarks>
+    ///     The message pattern should contain a single placeholder (e.g., <c>"{0}"</c>, <c>"Errors: {0}"</c>),
+    /// </remarks>
+    /// <param name="messagePattern">The message pattern to format the exception message.</param>
+    /// <param name="separator">The separator to use between problem details in the message, optional, defaults to newline character.</param>
+    /// <returns>A new instance of <see cref="InvalidOperationException"/>.</returns>
+    public InvalidOperationException ToException(string messagePattern, string separator = "\n")
+    {
+        var message = string.Format(messagePattern, string.Join(separator, this.Select(p => p.ToString())));
+        return new InvalidOperationException(message);
+    }
 }

src/RoyalCode.SmartProblems/Result'0.cs

@@ -196,7 +196,7 @@ public Problem this[int index]
     public void EnsureSuccess()
     {
         if (IsFailure)
-            throw new InvalidOperationException(string.Join("\n", problems.Select(p => p.ToString())));
+            throw problems.ToException();
     }
 
     #region Has/Is 

src/RoyalCode.SmartProblems/Result'1.cs

@@ -274,7 +274,7 @@ public Problem this[int index]
     public void EnsureSuccess()
     {
         if (IsFailure)
-            throw new InvalidOperationException(string.Join("\n", problems.Select(p => p.ToString())));
+            throw problems.ToException();
     }
 
     /// <summary>
@@ -288,7 +288,7 @@ public void EnsureSuccess()
     public void EnsureHasValue([NotNull] out TValue value)
     {
         if (IsFailure)
-            throw new InvalidOperationException(string.Join("\n", problems.Select(p => p.ToString())));
+            throw problems.ToException();
 
         value = this.value;
     }