Merge pull request #11 from Alos-no/develop

Develop

Author: alexis-

docs/docfx.json

@@ -73,7 +73,8 @@
         "apiSpecFolder": "docs/api"
       },
       "_gitUrlPattern": "github",
-      "_appFooter": "Built and maintained by <a href=\"https://alos.no\" target=\"_blank\" rel=\"noopener\">Alos Engineering</a> · Licensed under <a href=\"https://github.com/Alos-no/Cloudflare.NET/blob/main/LICENSE.txt\" target=\"_blank\" rel=\"noopener\">Apache 2.0</a>"
+      "_appFooter": "Built and maintained by <a href=\"https://alos.no\" target=\"_blank\" rel=\"noopener\">Alos Engineering</a> · Licensed under <a href=\"https://github.com/Alos-no/Cloudflare.NET/blob/main/LICENSE.txt\" target=\"_blank\" rel=\"noopener\">Apache 2.0</a>",
+      "_googleAnalyticsTagId": "G-J3X1J125E2"
     },
 
     "sitemap": {

samples/Cloudflare.NET.Sample.csproj/Samples/AccountSamples.cs

@@ -87,24 +87,24 @@ private async Task RunCorsConfigurationAsync(string bucketName)
         // Rule for local development
         new CorsRule(
           new CorsAllowed(
-            Methods: new[] { "GET", "PUT", "POST", "DELETE" },
-            Origins: new[] { "http://localhost:3000", "http://localhost:5173" },
-            Headers: new[] { "Content-Type", "Authorization" }
+            new[] { "GET", "PUT", "POST", "DELETE" },
+            new[] { "http://localhost:3000", "http://localhost:5173" },
+            new[] { "Content-Type", "Authorization" }
           ),
-          Id: "Local Development",
-          ExposeHeaders: new[] { "ETag", "Content-Length" },
-          MaxAgeSeconds: 3600
+          "Local Development",
+          new[] { "ETag", "Content-Length" },
+          3600
         ),
         // Rule for production
         new CorsRule(
           new CorsAllowed(
-            Methods: new[] { "GET", "HEAD" },
-            Origins: new[] { "https://example.com" },
-            Headers: new[] { "Content-Type" }
+            new[] { "GET", "HEAD" },
+            new[] { "https://example.com" },
+            new[] { "Content-Type" }
           ),
-          Id: "Production",
-          ExposeHeaders: new[] { "ETag" },
-          MaxAgeSeconds: 7200
+          "Production",
+          new[] { "ETag" },
+          7200
         )
       }
     );
@@ -132,11 +132,11 @@ private async Task RunCorsConfigurationAsync(string bucketName)
       {
         new CorsRule(
           new CorsAllowed(
-            Methods: new[] { "GET" },
-            Origins: new[] { "*" },
-            Headers: new[] { "Content-Type" }
+            new[] { "GET" },
+            new[] { "*" },
+            new[] { "Content-Type" }
           ),
-          Id: "Public Read",
+          "Public Read",
           MaxAgeSeconds: 86400
         )
       }
@@ -162,32 +162,32 @@ private async Task RunLifecycleConfigurationAsync(string bucketName)
       {
         // Rule to delete old log files after 90 days
         new LifecycleRule(
-          Id: "Delete old logs",
-          Enabled: true,
-          Conditions: new LifecycleRuleConditions("logs/"),
+          "Delete old logs",
+          true,
+          new LifecycleRuleConditions("logs/"),
           DeleteObjectsTransition: new DeleteObjectsTransition(LifecycleCondition.AfterDays(90))
         ),
         // Rule to abort incomplete multipart uploads after 7 days
         new LifecycleRule(
-          Id: "Cleanup incomplete uploads",
-          Enabled: true,
+          "Cleanup incomplete uploads",
+          true,
           AbortMultipartUploadsTransition: new AbortMultipartUploadsTransition(LifecycleCondition.AfterDays(7))
         ),
         // Rule to transition archived data to Infrequent Access storage class after 30 days
         new LifecycleRule(
-          Id: "Archive to Infrequent Access",
-          Enabled: true,
-          Conditions: new LifecycleRuleConditions("archive/"),
+          "Archive to Infrequent Access",
+          true,
+          new LifecycleRuleConditions("archive/"),
           StorageClassTransitions: new[]
           {
             new StorageClassTransition(LifecycleCondition.AfterDays(30), R2StorageClass.InfrequentAccess)
           }
         ),
         // Combined rule: transition to IA then delete (for temp files)
         new LifecycleRule(
-          Id: "Temp file lifecycle",
-          Enabled: true,
-          Conditions: new LifecycleRuleConditions("temp/"),
+          "Temp file lifecycle",
+          true,
+          new LifecycleRuleConditions("temp/"),
           StorageClassTransitions: new[]
           {
             new StorageClassTransition(LifecycleCondition.AfterDays(14), R2StorageClass.InfrequentAccess)
@@ -220,7 +220,8 @@ private async Task RunLifecycleConfigurationAsync(string bucketName)
 
       if (rule.StorageClassTransitions != null)
         foreach (var transition in rule.StorageClassTransitions)
-          logger.LogInformation("    Transition to {StorageClass} after: {Days} days", transition.StorageClass, transition.Condition.MaxAge);
+          logger.LogInformation("    Transition to {StorageClass} after: {Days} days", transition.StorageClass,
+                                transition.Condition.MaxAge);
     }
 
     // 3. Update Lifecycle Policy (simpler configuration)
@@ -230,8 +231,8 @@ private async Task RunLifecycleConfigurationAsync(string bucketName)
       {
         // Single rule: delete all objects after 365 days
         new LifecycleRule(
-          Id: "Annual cleanup",
-          Enabled: true,
+          "Annual cleanup",
+          true,
           DeleteObjectsTransition: new DeleteObjectsTransition(LifecycleCondition.AfterDays(365))
         )
       }

src/Cloudflare.NET/Accounts/IAccountsApi.cs

@@ -104,14 +104,16 @@ Task<CustomDomainResponse> AttachCustomDomainAsync(string            bucketName,
   /// <param name="corsPolicy">The CORS policy to apply to the bucket.</param>
   /// <param name="cancellationToken">A cancellation token.</param>
   /// <returns>A task that represents the asynchronous operation.</returns>
-  /// <seealso href="https://developers.cloudflare.com/api/resources/r2/subresources/buckets/subresources/cors/methods/update/" />
+  /// <seealso
+  ///   href="https://developers.cloudflare.com/api/resources/r2/subresources/buckets/subresources/cors/methods/update/" />
   Task SetBucketCorsAsync(string bucketName, BucketCorsPolicy corsPolicy, CancellationToken cancellationToken = default);
 
   /// <summary>Deletes the CORS policy for an R2 bucket, removing all CORS rules.</summary>
   /// <param name="bucketName">The name of the bucket.</param>
   /// <param name="cancellationToken">A cancellation token.</param>
   /// <returns>A task that represents the asynchronous operation.</returns>
-  /// <seealso href="https://developers.cloudflare.com/api/resources/r2/subresources/buckets/subresources/cors/methods/delete/" />
+  /// <seealso
+  ///   href="https://developers.cloudflare.com/api/resources/r2/subresources/buckets/subresources/cors/methods/delete/" />
   Task DeleteBucketCorsAsync(string bucketName, CancellationToken cancellationToken = default);
 
   /// <summary>Gets the lifecycle policy for an R2 bucket.</summary>
@@ -122,10 +124,11 @@ Task<CustomDomainResponse> AttachCustomDomainAsync(string            bucketName,
   ///   <see cref="BucketLifecyclePolicy" /> with the current lifecycle rules.
   /// </returns>
   /// <remarks>
-  ///   Lifecycle rules determine object retention, automatic deletion, storage class transitions,
-  ///   and cleanup of incomplete multipart uploads. A bucket can have up to 1000 lifecycle rules.
+  ///   Lifecycle rules determine object retention, automatic deletion, storage class transitions, and cleanup of
+  ///   incomplete multipart uploads. A bucket can have up to 1000 lifecycle rules.
   /// </remarks>
-  /// <seealso href="https://developers.cloudflare.com/api/resources/r2/subresources/buckets/subresources/lifecycle/methods/get/" />
+  /// <seealso
+  ///   href="https://developers.cloudflare.com/api/resources/r2/subresources/buckets/subresources/lifecycle/methods/get/" />
   Task<BucketLifecyclePolicy> GetBucketLifecycleAsync(string bucketName, CancellationToken cancellationToken = default);
 
   /// <summary>Sets or updates the lifecycle policy for an R2 bucket.</summary>
@@ -136,22 +139,29 @@ Task<CustomDomainResponse> AttachCustomDomainAsync(string            bucketName,
   /// <remarks>
   ///   <para>Lifecycle rules can perform the following actions:</para>
   ///   <list type="bullet">
-  ///     <item><description>Delete objects after a specified age or on a specific date</description></item>
-  ///     <item><description>Abort incomplete multipart uploads after a specified age</description></item>
-  ///     <item><description>Transition objects to Infrequent Access storage class</description></item>
+  ///     <item>
+  ///       <description>Delete objects after a specified age or on a specific date</description>
+  ///     </item>
+  ///     <item>
+  ///       <description>Abort incomplete multipart uploads after a specified age</description>
+  ///     </item>
+  ///     <item>
+  ///       <description>Transition objects to Infrequent Access storage class</description>
+  ///     </item>
   ///   </list>
   ///   <para>Rules are processed within 24 hours of being set. Maximum of 1000 rules per bucket.</para>
   /// </remarks>
-  /// <seealso href="https://developers.cloudflare.com/api/resources/r2/subresources/buckets/subresources/lifecycle/methods/update/" />
+  /// <seealso
+  ///   href="https://developers.cloudflare.com/api/resources/r2/subresources/buckets/subresources/lifecycle/methods/update/" />
   Task SetBucketLifecycleAsync(string bucketName, BucketLifecyclePolicy lifecyclePolicy, CancellationToken cancellationToken = default);
 
   /// <summary>Deletes the lifecycle policy for an R2 bucket, removing all lifecycle rules.</summary>
   /// <param name="bucketName">The name of the bucket.</param>
   /// <param name="cancellationToken">A cancellation token.</param>
   /// <returns>A task that represents the asynchronous operation.</returns>
   /// <remarks>
-  ///   Cloudflare R2 does not have a dedicated DELETE endpoint for lifecycle policies.
-  ///   This method removes the policy by setting an empty rules array.
+  ///   Cloudflare R2 does not have a dedicated DELETE endpoint for lifecycle policies. This method removes the policy
+  ///   by setting an empty rules array.
   /// </remarks>
   /// <seealso href="https://developers.cloudflare.com/r2/buckets/object-lifecycles/" />
   Task DeleteBucketLifecycleAsync(string bucketName, CancellationToken cancellationToken = default);

src/Cloudflare.NET/Accounts/Models/R2BucketModels.cs

@@ -4,7 +4,6 @@ namespace Cloudflare.NET.Accounts.Models;
 using System.Text.Json.Serialization;
 using Core.Json;
 
-
 #region Bucket Models
 
 /// <summary>Defines the request payload for creating an R2 bucket.</summary>
@@ -52,7 +51,6 @@ IReadOnlyList<R2Bucket> Buckets
 
 #endregion
 
-
 #region CORS Models
 
 /// <summary>Defines the allowed HTTP methods, origins, and headers for a CORS rule.</summary>
@@ -93,20 +91,17 @@ IReadOnlyList<CorsRule> Rules
 
 #endregion
 
-
 #region Lifecycle Models
 
 /// <summary>Defines the condition type for lifecycle rule transitions.</summary>
 [JsonConverter(typeof(JsonStringEnumMemberConverter))]
 public enum LifecycleConditionType
 {
   /// <summary>Condition based on object age in days.</summary>
-  [EnumMember(Value = "Age")]
-  Age,
+  [EnumMember(Value = "Age")] Age,
 
   /// <summary>Condition based on a specific date.</summary>
-  [EnumMember(Value = "Date")]
-  Date
+  [EnumMember(Value = "Date")] Date
 }
 
 /// <summary>Represents a condition that triggers a lifecycle transition.</summary>
@@ -129,13 +124,13 @@ public record LifecycleCondition(
   /// <param name="days">The number of days after object creation.</param>
   /// <returns>A new <see cref="LifecycleCondition" /> with Age type and MaxAge in seconds.</returns>
   public static LifecycleCondition AfterDays(int days) =>
-    new(LifecycleConditionType.Age, MaxAge: days * SecondsPerDay);
+    new(LifecycleConditionType.Age, days * SecondsPerDay);
 
   /// <summary>Creates an age-based lifecycle condition using seconds.</summary>
   /// <param name="seconds">The number of seconds after object creation.</param>
   /// <returns>A new <see cref="LifecycleCondition" /> with Age type and MaxAge in seconds.</returns>
   public static LifecycleCondition AfterSeconds(int seconds) =>
-    new(LifecycleConditionType.Age, MaxAge: seconds);
+    new(LifecycleConditionType.Age, seconds);
 
   /// <summary>Creates a date-based lifecycle condition.</summary>
   /// <param name="date">The date on which the transition should occur.</param>
@@ -145,7 +140,10 @@ public static LifecycleCondition OnDate(DateTime date) =>
 }
 
 /// <summary>Represents the filtering conditions for which objects a lifecycle rule applies to.</summary>
-/// <param name="Prefix">The object key prefix to filter objects. Only objects with keys starting with this prefix are affected.</param>
+/// <param name="Prefix">
+///   The object key prefix to filter objects. Only objects with keys starting with this prefix are
+///   affected.
+/// </param>
 public record LifecycleRuleConditions(
   [property: JsonPropertyName("prefix")]
   string? Prefix = null
@@ -168,11 +166,15 @@ LifecycleCondition Condition
 /// <summary>Defines the available R2 storage classes for lifecycle transitions.</summary>
 public static class R2StorageClass
 {
+  #region Constants & Statics
+
   /// <summary>Standard storage class for frequently accessed data.</summary>
   public const string Standard = "Standard";
 
   /// <summary>Infrequent Access storage class for less frequently accessed data with lower storage costs.</summary>
   public const string InfrequentAccess = "InfrequentAccess";
+
+  #endregion
 }
 
 /// <summary>Represents a transition to change the storage class of objects.</summary>

src/Cloudflare.NET/Core/ApiResource.cs

@@ -96,8 +96,8 @@ protected async Task<TResult> PutAsync<TResult>(string requestUri, object? paylo
 
   /// <summary>Sends a POST request with a pre-serialized JSON string to the specified URI.</summary>
   /// <remarks>
-  ///   Use this method when you need custom JSON serialization (e.g., camelCase instead of snake_case).
-  ///   The caller is responsible for serializing the payload to JSON.
+  ///   Use this method when you need custom JSON serialization (e.g., camelCase instead of snake_case). The caller is
+  ///   responsible for serializing the payload to JSON.
   /// </remarks>
   /// <typeparam name="TResult">The expected type of the "result" object in the JSON response.</typeparam>
   /// <param name="requestUri">The URI to send the request to.</param>
@@ -108,7 +108,7 @@ protected async Task<TResult> PostJsonAsync<TResult>(string            requestUr
                                                        string            jsonContent,
                                                        CancellationToken cancellationToken = default)
   {
-    using var scope   = Logger.BeginScope("RequestUri: {RequestUri}", requestUri);
+    using var scope = Logger.BeginScope("RequestUri: {RequestUri}", requestUri);
     Logger.SendingRequest("POST", requestUri);
     var content  = new StringContent(jsonContent, System.Text.Encoding.UTF8, "application/json");
     var response = await HttpClient.PostAsync(requestUri, content, cancellationToken);
@@ -117,8 +117,8 @@ protected async Task<TResult> PostJsonAsync<TResult>(string            requestUr
 
   /// <summary>Sends a PUT request with a pre-serialized JSON string to the specified URI.</summary>
   /// <remarks>
-  ///   Use this method when you need custom JSON serialization (e.g., camelCase instead of snake_case).
-  ///   The caller is responsible for serializing the payload to JSON.
+  ///   Use this method when you need custom JSON serialization (e.g., camelCase instead of snake_case). The caller is
+  ///   responsible for serializing the payload to JSON.
   /// </remarks>
   /// <typeparam name="TResult">The expected type of the "result" object in the JSON response.</typeparam>
   /// <param name="requestUri">The URI to send the request to.</param>
@@ -129,7 +129,7 @@ protected async Task<TResult> PutJsonAsync<TResult>(string            requestUri
                                                       string            jsonContent,
                                                       CancellationToken cancellationToken = default)
   {
-    using var scope   = Logger.BeginScope("RequestUri: {RequestUri}", requestUri);
+    using var scope = Logger.BeginScope("RequestUri: {RequestUri}", requestUri);
     Logger.SendingRequest("PUT", requestUri);
     var content  = new StringContent(jsonContent, System.Text.Encoding.UTF8, "application/json");
     var response = await HttpClient.PutAsync(requestUri, content, cancellationToken);

src/Cloudflare.NET/Core/Auth/AuthLogs.cs

@@ -9,6 +9,7 @@ namespace Cloudflare.NET.Core.Auth;
 internal static partial class AuthLogs
 {
 #if NET6_0_OR_GREATER
+
   #region Source-Generated Logging (NET6+)
 
   [LoggerMessage(
@@ -20,7 +21,6 @@ internal static partial class AuthLogs
   #endregion
 
 #else
-
   #region Manual Logging (NetStandard2.1)
 
   public static void AddingAuthHeader(this ILogger logger, Uri? requestUri)

src/Cloudflare.NET/Core/Internal/CallerArgumentExpressionAttribute.cs

@@ -1,5 +1,4 @@
 #if !NET5_0_OR_GREATER
-
 // ReSharper disable once CheckNamespace
 namespace System.Runtime.CompilerServices;
 

src/Cloudflare.NET/Core/Internal/IsExternalInit.cs

@@ -1,5 +1,4 @@
 #if !NET5_0_OR_GREATER
-
 // ReSharper disable once CheckNamespace
 namespace System.Runtime.CompilerServices;
 

src/Cloudflare.NET/Core/Json/SnakeCaseNamingPolicy.cs

@@ -1,5 +1,4 @@
 #if !NET8_0_OR_GREATER
-
 namespace Cloudflare.NET.Core.Json;
 
 using System.Buffers;
@@ -57,12 +56,12 @@ public override string ConvertName(string name)
 
     try
     {
-      var bufferIndex      = 0;
+      var bufferIndex = 0;
       var previousCategory = CharCategory.Boundary;
 
       for (var i = 0; i < name.Length; i++)
       {
-        var current         = name[i];
+        var current = name[i];
         var currentCategory = GetCharCategory(current);
 
         // Determine if we need to insert an underscore before this character.
@@ -104,7 +103,7 @@ public override string ConvertName(string name)
         }
 
         buffer[bufferIndex++] = char.ToLowerInvariant(current);
-        previousCategory      = currentCategory;
+        previousCategory = currentCategory;
       }
 
       return new string(buffer, 0, bufferIndex);

src/Cloudflare.NET/Core/Models/ApiResourceLogs.cs

@@ -9,6 +9,7 @@ namespace Cloudflare.NET.Core.Models;
 internal static partial class ApiResourceLogs
 {
 #if NET6_0_OR_GREATER
+
   #region Source-Generated Logging (NET6+)
 
   [LoggerMessage(
@@ -67,7 +68,6 @@ public static partial void ApiReturnedFailure(
   #endregion
 
 #else
-
   #region Manual Logging (NetStandard2.1)
 
   public static void SendingRequest(this ILogger logger, string method, string requestUri)