feat: enhance release synchronization with cancellation support, error handling, and logging

- Added `CancellationToken` support across SyncService, GithubService, ForgejoService, and ReleaseAssetDownloadService.
- Improved error handling with detailed logging for asset downloads, deletions, and API operations.
- Refactored SyncService for clearer repository and asset synchronization logic.
- Enhanced performance with async file streams and refined conditional checks.

Services/ForgejoService.cs

@@ -1,5 +1,4 @@
 using System.Net.Http.Headers;
-using System.Net.Http.Json;
 using System.Text;
 using System.Text.Json;
 using ForgejoReleaseSync.DTOs.Forgejo;
@@ -9,80 +8,87 @@ namespace ForgejoReleaseSync.Services;
 
 public class ForgejoService(HttpClient httpClient, AppConfig config, ILogger<ForgejoService> logger)
 {
-    public async Task<List<ForgejoReleaseResponseDto>> CreateReleaseAsync(string owner, string repo, string body, string name, string tagName, CancellationToken token = default)
+    public async Task<ForgejoReleaseResponseDto> CreateReleaseAsync(
+        string owner, string repo, string body, string name, string tagName, CancellationToken token = default)
     {
         try
         {
             var dto = new ForgejoCreateReleaseDto(body, false, false, name, false, tagName, "");
-        
             var json = JsonSerializer.Serialize(dto, AppJsonSerializerContext.Default.ForgejoCreateReleaseDto);
-            using var content = new StringContent(json, Encoding.UTF8, "application/json");
-            
-            using var request = new HttpRequestMessage(HttpMethod.Post, new Uri($"{config.ForgejoInstacne}/api/v1/repos/{owner}/{repo}/releases"));
-            request.Content = content;
 
-            request.Headers.Authorization =
-                new AuthenticationHeaderValue("token", config.ForgejoToken);
+            using var request = new HttpRequestMessage(
+                HttpMethod.Post,
+                new Uri($"{config.ForgejoInstacne}/api/v1/repos/{owner}/{repo}/releases"));
+            request.Content = new StringContent(json, Encoding.UTF8, "application/json");
+            request.Headers.Authorization = new AuthenticationHeaderValue("token", config.ForgejoToken);
 
             using var response = await httpClient.SendAsync(request, token);
             response.EnsureSuccessStatusCode();
-            
-            var responseStream = await response.Content.ReadAsStreamAsync(token);
-            var releases = await JsonSerializer.DeserializeAsync(responseStream,
-                AppJsonSerializerContext.Default.ListForgejoReleaseResponseDto, token);
 
-            return releases ?? [];
-            
-            
+            await using var stream = await response.Content.ReadAsStreamAsync(token);
+            var created = await JsonSerializer.DeserializeAsync(
+                stream, AppJsonSerializerContext.Default.ForgejoReleaseResponseDto, token);
+
+            return created ?? throw new InvalidOperationException("Forgejo returned an empty release response");
         }
-        catch (Exception e)
+        catch (Exception ex)
         {
-            logger.LogError(e, "Failed to create forgejo release");
+            logger.LogError(ex, "Failed to create Forgejo release {Tag} for {Owner}/{Repo}", tagName, owner, repo);
             throw;
         }
-        
     }
 
-    public async Task<List<ForgejoReleaseResponseDto>> FetchRepoReleasesAsync(string owner, string repo, CancellationToken token = default)
+    public async Task<List<ForgejoReleaseResponseDto>> FetchRepoReleasesAsync(
+        string owner, string repo, CancellationToken token = default)
     {
         try
         {
-            var response = await httpClient.GetAsync(
-                new Uri($"{config.ForgejoInstacne}/api/v1/repos/{owner}/{repo}/releases?per_page=3&page=1"));
-
+            using var response = await httpClient.GetAsync(
+                new Uri($"{config.ForgejoInstacne}/api/v1/repos/{owner}/{repo}/releases?per_page=3&page=1"),
+                token);
             response.EnsureSuccessStatusCode();
 
-            var responseStream = await response.Content.ReadAsStreamAsync(token);
-            var releases = await JsonSerializer.DeserializeAsync(responseStream,
-                AppJsonSerializerContext.Default.ListForgejoReleaseResponseDto, token);
+            await using var stream = await response.Content.ReadAsStreamAsync(token);
+            var releases = await JsonSerializer.DeserializeAsync(
+                stream, AppJsonSerializerContext.Default.ListForgejoReleaseResponseDto, token);
 
             return releases ?? [];
         }
         catch (Exception ex)
         {
-            logger.LogError(ex, "Failed to fetch forgejo releases");
+            logger.LogError(ex, "Failed to fetch Forgejo releases for {Owner}/{Repo}", owner, repo);
             throw;
         }
     }
 
-    public async Task UploadReleaseAssetAsync(string owner, string repo, long releaseId, string filePath, CancellationToken token = default)
+    public async Task UploadReleaseAssetAsync(
+        string owner, string repo, long releaseId, string filePath, CancellationToken token = default)
     {
-        using var request = new HttpRequestMessage(HttpMethod.Post, new Uri($"{config.ForgejoInstacne}/api/v1/repos/{owner}/{repo}/releases/{releaseId}/assets"));
-        
-        request.Headers.Authorization =
-            new AuthenticationHeaderValue("token", config.ForgejoToken);
-        
-        await using var fileStream = new FileStream(filePath, FileMode.Open, FileAccess.Read, FileShare.Read, 4096, true);
-        using var fileContent = new StreamContent(fileStream);
-        fileContent.Headers.ContentType = new MediaTypeHeaderValue("application/octet-stream");
-        
-        using var formData = new MultipartFormDataContent();
-        formData.Add(fileContent, "attachment", Path.GetFileName(filePath));
-        
-        request.Content = formData;
+        try
+        {
+            await using var fileStream = new FileStream(
+                filePath, FileMode.Open, FileAccess.Read, FileShare.Read, 4096, useAsync: true);
 
-        using var response = await httpClient.SendAsync(request,HttpCompletionOption.ResponseHeadersRead, token);
-        
-        response.EnsureSuccessStatusCode();
+            using var fileContent = new StreamContent(fileStream);
+            fileContent.Headers.ContentType = new MediaTypeHeaderValue("application/octet-stream");
+
+            using var formData = new MultipartFormDataContent();
+            formData.Add(fileContent, "attachment", Path.GetFileName(filePath));
+
+            using var request = new HttpRequestMessage(
+                HttpMethod.Post,
+                new Uri($"{config.ForgejoInstacne}/api/v1/repos/{owner}/{repo}/releases/{releaseId}/assets"));
+            request.Content = formData;
+            request.Headers.Authorization = new AuthenticationHeaderValue("token", config.ForgejoToken);
+
+            using var response = await httpClient.SendAsync(
+                request, HttpCompletionOption.ResponseHeadersRead, token);
+            response.EnsureSuccessStatusCode();
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "Failed to upload asset {Path} to {Owner}/{Repo}", filePath, owner, repo);
+            throw;
+        }
     }
 }