Add UploadIniaited, Completed, and Failed event progress trackers to SimpleUploadCommand

[GarrettBeatty]

This change creates 3 event progress trackers for SimpleUploadCommand. UploadInitiatedEvent, UploadedCompletedEvent, and UploadFailedEvent. This allows the user to subscribe to events like doing below

        private void uploadStarted(object sender, UploadInitiatedEventArgs args)
         {
             Console.WriteLine($"Upload started: {args.FilePath}");
             Console.WriteLine($"Total size: {args.TotalBytes} bytes");
             Console.WriteLine($"Bucket: {args.Request.BucketName}");
             Console.WriteLine($"Key: {args.Request.Key}");
         }


         TransferUtilityUploadRequest request = new TransferUtilityUploadRequest();
         request.UploadInitiatedEvent += uploadStarted;

These new events should only be fired 1 time during the entire lifecycle of the upload. The details of what each event should contain is in the SEP.

Description

1. DOTNET-8275

Motivation and Context

This is being done as part of the SEP compliance.

Testing

1. Integration tests/unit tests which demonstrate the event handler behavior
2. dry run d0657a6a-92ce-4d24-99d8-15a473e66554

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)

Checklist

• My code follows the code style of this project
• My change requires a change to the documentation
• I have updated the documentation accordingly
• I have read the README document
• I have added tests to cover my changes
• All new and existing tests passed

License

• I confirm that this pull request can be released under the Apache 2 license

[Copilot]

Pull Request Overview

This PR implements simple upload progress tracking for the AWS .NET SDK S3 Transfer Utility by adding lifecycle events (initiated, completed, failed) and creating a unified upload response class. It introduces a comprehensive testing framework with JSON-based field mapping validation to ensure response completeness.

Key Changes:

• Added three new lifecycle events (UploadInitiatedEvent, UploadCompletedEvent, UploadFailedEvent) to TransferUtilityUploadRequest
• Created TransferUtilityUploadResponse class to unify response data from different upload operations
• Implemented ResponseMapper utility for mapping S3 response objects to the unified response format

Reviewed Changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
TransferUtilityUploadRequest.cs	Added lifecycle event handlers and event argument classes
TransferUtilityUploadResponse.cs	New unified response class with properties mapped from S3 operations
SimpleUploadCommand.cs	Added event firing logic and progress tracking
SimpleUploadCommand.async.cs	Added async event firing and response mapping
ResponseMapper.cs	New utility class for mapping S3 responses to unified format
ResponseMapperTests.cs	Comprehensive test suite with JSON-driven validation
TransferUtilityTests.cs	Integration tests for lifecycle events
AssemblyInfo.cs	Added InternalsVisibleTo for unit testing
mapping.json	JSON configuration defining field mappings between response types
property-aliases.json	Property name aliases for backward compatibility
mapping-schema.json	JSON schema validation for mapping configuration

[Copilot]

Pull Request Overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 4 comments.

[Copilot]

The use of Interlocked.Add for thread-safe tracking of transferred bytes is correct, but consider potential race conditions where the final transferred bytes count might not accurately reflect the state at the exact moment of failure in multi-threaded scenarios.

[Copilot]

The hardcoded navigation logic to find test data files is fragile and could break with different build configurations or directory structures. Consider using a more robust approach like [DeploymentItem] attribute or embedded resources.