v2.0.0 - .NET 10 GA & Polly v8 Migration

## Major Changes

### .NET 10 GA Migration
- Migrated from .NET 10 Preview to stable GA release
- Removed EnablePreviewFeatures flag
- Updated to latestMajor LangVersion

### Polly v8 Modernization
- Upgraded from Polly 7.2.4 to 8.6.4
- Migrated from legacy IAsyncPolicy to ResiliencePipeline API
- Replaced Policy.Handle/WaitAndRetryAsync with ResiliencePipelineBuilder
- Adopted modern retry strategy with exponential backoff
- Updated exception handling to support OperationCanceledException
- Improved code readability and maintainability

### Code Improvements
- Refactored GeminiService to use Polly v8 idioms
- Updated retry configuration to use new declarative API
- Enhanced error handling for cancelled operations
- Updated unit tests to accommodate Polly v8 behavior
- Removed obsolete policy construction code

### Documentation
- Updated README with Polly v8 badge
- Added resilient HTTP communication description
- Removed preview-specific configuration notes

## Breaking Changes
- Requires .NET 10 GA (released Nov 12, 2025)
- Polly dependency upgraded to v8.x (may affect consumers using Polly directly)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: ANcpLua

.idea/.idea.SWEN3.Paperless.RabbitMq/.idea/projectSettingsUpdater.xml

@@ -1,11 +1,12 @@
 [![codecov](https://codecov.io/gh/ANcpLua/SWEN3.Paperless.RabbitMq/branch/main/graph/badge.svg?token=lgxIXBnFrn)](https://codecov.io/gh/ANcpLua/SWEN3.Paperless.RabbitMq)
 [![.NET 10](https://img.shields.io/badge/.NET-10.0-7C3AED)](https://dotnet.microsoft.com/download/dotnet/10.0)
 [![NuGet](https://img.shields.io/nuget/v/SWEN3.Paperless.RabbitMq?label=NuGet&color=0891B2)](https://www.nuget.org/packages/SWEN3.Paperless.RabbitMq/)
+[![Polly](https://img.shields.io/badge/Polly-8.6.4-00ACC1)](https://github.com/App-vNext/Polly)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/ANcpLua/SWEN3.Paperless.RabbitMq/blob/main/LICENSE)
 
 # SWEN3.Paperless.RabbitMq
 
-RabbitMQ messaging library for .NET with SSE support and AI-powered document summarization.
+RabbitMQ messaging library for .NET 10 with SSE support, AI-powered document summarization, and resilient HTTP communication using Polly v8.
 
 ## Configuration
 

.idea/.idea.SWEN3.Paperless.RabbitMq/.idea/workspace.xml

@@ -134,7 +134,7 @@ public async Task SummarizeAsync_WhenCanceled_ReturnsNull()
         logger.Verify(
             l => l.Log(LogLevel.Error, It.IsAny<EventId>(),
                 It.Is<It.IsAnyType>((o, t) => o.ToString()!.Contains("failed after")),
-                It.IsAny<TaskCanceledException>(), It.IsAny<Func<It.IsAnyType, Exception?, string>>()), Times.Once);
+                It.IsAny<Exception>(), It.IsAny<Func<It.IsAnyType, Exception?, string>>()), Times.Once);
     }
 
     private GeminiService CreateService(HttpClient httpClient)

README.md

@@ -4,6 +4,7 @@
 using Microsoft.Extensions.Logging;
 using Microsoft.Extensions.Options;
 using Polly;
+using Polly.Retry;
 
 namespace SWEN3.Paperless.RabbitMq.GenAI;
 
@@ -26,7 +27,7 @@ public sealed class GeminiService : ITextSummarizer
     private readonly HttpClient _httpClient;
     private readonly ILogger<GeminiService> _logger;
     private readonly GeminiOptions _options;
-    private readonly IAsyncPolicy<HttpResponseMessage> _retryPolicy;
+    private readonly ResiliencePipeline<HttpResponseMessage> _resiliencePipeline;
 
     /// <summary>
     ///     Initializes a new instance of the <see cref="GeminiService"/> class.
@@ -35,8 +36,8 @@ public sealed class GeminiService : ITextSummarizer
     /// <param name="options">Configuration options containing API key, model selection, and retry settings.</param>
     /// <param name="logger">Logger instance for diagnostic output and error tracking.</param>
     /// <remarks>
-    ///     The constructor configures the HTTP client timeout and initializes a Polly retry policy
-    ///     with exponential backoff for handling transient failures and rate limiting.
+    ///     The constructor configures the HTTP client timeout and initializes a Polly v8 resilience pipeline
+    ///     with exponential backoff retry strategy for handling transient failures and rate limiting.
     /// </remarks>
     public GeminiService(HttpClient httpClient, IOptions<GeminiOptions> options, ILogger<GeminiService> logger)
     {
@@ -46,14 +47,25 @@ public GeminiService(HttpClient httpClient, IOptions<GeminiOptions> options, ILo
 
         _httpClient.Timeout = TimeSpan.FromSeconds(_options.TimeoutSeconds);
 
-        _retryPolicy = Policy<HttpResponseMessage>.Handle<HttpRequestException>()
-            .OrResult(resp => (int)resp.StatusCode >= 500 || resp.StatusCode == HttpStatusCode.RequestTimeout ||
-                              resp.StatusCode == HttpStatusCode.TooManyRequests).WaitAndRetryAsync(_options.MaxRetries,
-                retryAttempt => TimeSpan.FromSeconds(Math.Pow(2, retryAttempt)),
-                (_, timespan, retryCount, _) =>
+        _resiliencePipeline = new ResiliencePipelineBuilder<HttpResponseMessage>()
+            .AddRetry(new RetryStrategyOptions<HttpResponseMessage>
+            {
+                MaxRetryAttempts = _options.MaxRetries,
+                BackoffType = DelayBackoffType.Exponential,
+                Delay = TimeSpan.FromSeconds(1),
+                ShouldHandle = new PredicateBuilder<HttpResponseMessage>()
+                    .Handle<HttpRequestException>()
+                    .HandleResult(resp => (int)resp.StatusCode >= 500
+                                          || resp.StatusCode == HttpStatusCode.RequestTimeout
+                                          || resp.StatusCode == HttpStatusCode.TooManyRequests),
+                OnRetry = args =>
                 {
-                    _logger.LogWarning("Gemini retry {Count} after {Delay}s", retryCount, timespan.TotalSeconds);
-                });
+                    _logger.LogWarning("Gemini retry {Count} after {Delay}s",
+                        args.AttemptNumber, args.RetryDelay.TotalSeconds);
+                    return ValueTask.CompletedTask;
+                }
+            })
+            .Build();
     }
 
     /// <summary>
@@ -86,13 +98,13 @@ public GeminiService(HttpClient httpClient, IOptions<GeminiOptions> options, ILo
         HttpResponseMessage response;
         try
         {
-            response = await _retryPolicy.ExecuteAsync(async () =>
+            response = await _resiliencePipeline.ExecuteAsync(async ct =>
             {
                 using var content = new StringContent(JsonSerializer.Serialize(body), Encoding.UTF8, "application/json");
-                return await _httpClient.PostAsync(url, content, cancellationToken).ConfigureAwait(false);
-            }).ConfigureAwait(false);
+                return await _httpClient.PostAsync(url, content, ct).ConfigureAwait(false);
+            }, cancellationToken).ConfigureAwait(false);
         }
-        catch (Exception ex) when (ex is HttpRequestException or TaskCanceledException)
+        catch (Exception ex) when (ex is HttpRequestException or TaskCanceledException or OperationCanceledException)
         {
             _logger.LogError(ex, "Gemini API call failed after {MaxRetries} retries", _options.MaxRetries);
             return null;

SWEN3.Paperless.RabbitMq.Tests/Unit/GeminiServiceTests.cs

@@ -6,7 +6,7 @@
         <Nullable>enable</Nullable>
         <LangVersion>latestMajor</LangVersion>
         <PackageId>SWEN3.Paperless.RabbitMq</PackageId>
-        <Version>1.0.5</Version>
+        <Version>2.0.0</Version>
         <Authors>Alexander Nachtmann</Authors>
         <Description>RabbitMQ messaging and SSE support for Paperless</Description>
         <PackageTags>rabbitmq;sse;messaging;paperless;net10</PackageTags>
@@ -25,7 +25,7 @@
     </PropertyGroup>
 
     <ItemGroup>
-        <PackageReference Include="Polly" Version="7.2.4" />
+        <PackageReference Include="Polly" Version="8.6.4" />
         <PackageReference Include="RabbitMQ.Client" Version="7.1.2"/>
     </ItemGroup>