feat(api): enhance PlaidException for detailed error logging and improve GlobalExceptionHandler for specific Plaid errors

src/FiscalOS.API/Common/GlobalExceptionHandler.cs

@@ -1,3 +1,5 @@
+using FiscalOS.Infra.Common;
+
 using Microsoft.AspNetCore.Diagnostics;
 
 internal sealed class GlobalExceptionHandler(
@@ -11,7 +13,23 @@ internal sealed class GlobalExceptionHandler(
     CancellationToken cancellationToken
   )
   {
+    switch (exception)
+    {
+      case PlaidException plaidException:
+        logger.LogError(
+          plaidException,
+          "Unhandled Plaid exception. PlaidRequestId: {PlaidRequestId}, PlaidStatusCode: {PlaidStatusCode}, PlaidErrorCode: {PlaidErrorCode}, PlaidErrorType: {PlaidErrorType}, PlaidErrorMessage: {PlaidErrorMessage}",
+          plaidException.RequestId,
+          plaidException.StatusCode,
+          plaidException.ErrorCode,
+          plaidException.ErrorType,
+          plaidException.ErrorMessage
+        );
+        break;
+      default:
         logger.LogError(exception, "An unhandled exception occurred");
+        break;
+    }
 
     httpContext.Response.StatusCode = StatusCodes.Status500InternalServerError;
 

src/FiscalOS.Infra/Accounts/Plaid/PlaidAccountService.cs

@@ -107,7 +107,10 @@ internal sealed class PlaidAccountService : IPlaidAccountService
     if (itemResponse.IsSuccessStatusCode is false)
     {
       throw new PlaidException(
-        "Unable to retrieve item"
+        "Unable to retrieve item",
+        itemResponse.Error,
+        itemResponse.RequestId,
+        (int?)itemResponse.StatusCode
       );
     }
 

src/FiscalOS.ServiceDefaults/ServiceDefaultsExtensions.cs

@@ -33,6 +33,7 @@ public static class ServiceDefaultsExtensions
     {
       logging.IncludeFormattedMessage = true;
       logging.IncludeScopes = true;
+      logging.ParseStateValues = true;
     });
 
     builder.Services.AddOpenTelemetry()