refactor(amazon): Encapsulate S3 client with wrapper methods (#1636)

src/ModularPipelines.AmazonWebServices/AmazonProvisioner.cs

@@ -1,11 +1,19 @@
 namespace ModularPipelines.AmazonWebServices;
 
+/// <summary>
+/// Provides access to AWS resource provisioning services.
+/// </summary>
 internal class AmazonProvisioner : IAmazonProvisioner
 {
-    public AmazonProvisioner(S3 s3)
+    /// <summary>
+    /// Initializes a new instance of the <see cref="AmazonProvisioner"/> class.
+    /// </summary>
+    /// <param name="s3">The S3 service instance.</param>
+    public AmazonProvisioner(IS3 s3)
     {
         S3 = s3;
     }
 
-    public S3 S3 { get; }
+    /// <inheritdoc />
+    public IS3 S3 { get; }
 }

src/ModularPipelines.AmazonWebServices/Extensions/AmazonExtensions.cs

@@ -24,7 +24,7 @@ public static IServiceCollection RegisterAmazonContext(this IServiceCollection s
     {
         services.TryAddScoped<IAmazon, AmazonWebServices.Amazon>();
         services.TryAddScoped<IAmazonProvisioner, AmazonProvisioner>();
-        services.TryAddScoped<S3>();
+        services.TryAddScoped<IS3, S3>();
 
         services.TryAddScoped<Aws>();
         services.TryAddScoped<AwsAccessanalyzer>();

src/ModularPipelines.AmazonWebServices/IAmazonProvisioner.cs

@@ -1,6 +1,12 @@
 namespace ModularPipelines.AmazonWebServices;
 
+/// <summary>
+/// Provides access to AWS resource provisioning services.
+/// </summary>
 public interface IAmazonProvisioner
 {
-    S3 S3 { get; }
+    /// <summary>
+    /// Gets the S3 service for bucket and object management.
+    /// </summary>
+    IS3 S3 { get; }
 }