Add Progress listeners for initiated, complete, and failed for simple upload

[GarrettBeatty]

Stacked PRs:

• add OpenStreamResponse mapping #4064
• Add DownloadResponse mapping #4063
• uploadwithresponse api #4062
• multipart upload event lifecycles #4061
• add completeuploadresponse mapping to turesponse object #4060
• ->Add Progress listeners for initiated, complete, and failed for simple upload #4059

---

Description

This change adds progress listeners for "initiated", "complete", and "failed" lifecycle events for the SimpleUploadCommand (non multipart). Consumers can subscribe to these callbacks to receive notifications when a simple upload starts, finishes successfully, or fails. We will also make this change for multi part upload command here #4061

Example usage

// Create a TransferUtilityUploadRequest
TransferUtilityUploadRequest request = new TransferUtilityUploadRequest();

// Subscribe to the progress events
request.UploadInitiatedEvent += Request_UploadInitiatedEvent;
request.UploadCompletedEvent += Request_UploadCompletedEvent;
request.UploadFailedEvent += Request_UploadFailedEvent;

// Use the Transfer Utility to upload the file
using (var transferUtility = new TransferUtility(s3Client))
{
    transferUtility.UploadAsync(request);
}

private void Request_UploadInitiatedEvent(object sender, UploadInitiatedEventArgs e)
{
    Console.WriteLine($"Upload initiated for file: {e.FilePath}");
    Console.WriteLine($"Total bytes to transfer: {e.TotalBytes}");
}

private void Request_UploadCompletedEvent(object sender, UploadCompletedEventArgs e)
{
    Console.WriteLine($"Upload completed for file: {e.FilePath}");
    Console.WriteLine($"Transferred bytes: {e.TransferredBytes}");
    Console.WriteLine($"ETag: {e.Response.ETag}");
    Console.WriteLine($"Version ID: {e.Response.VersionId}");
}

private void Request_UploadFailedEvent(object sender, UploadFailedEventArgs e)
{
    Console.WriteLine($"Upload failed for file: {e.FilePath}");
    Console.WriteLine($"Transferred bytes: {e.TransferredBytes} / {e.TotalBytes}");
}

Motivation and Context

1. To adhere to the SEP

Testing

1. 46a4bf17-39fd-41e9-b625-1fba1b49f5a4 - pass
2. Integration tests

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 adds lifecycle event notifications (initiated, completed, and failed) for simple uploads in the AWS S3 Transfer Utility. The implementation provides developers with more granular visibility into upload operations beyond just progress tracking.

Key changes:

• Added three new event types: UploadInitiatedEvent, UploadCompletedEvent, and UploadFailedEvent to TransferUtilityUploadRequest
• Enhanced SimpleUploadCommand to fire these events at appropriate lifecycle stages
• Added comprehensive test coverage for all new event scenarios

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
TransferUtilityUploadRequest.cs	Added three new event handlers and corresponding event argument classes with detailed documentation
SimpleUploadCommand.cs	Enhanced with lifecycle event firing methods and improved progress tracking with thread-safe counters
SimpleUploadCommand.async.cs	Updated async execution flow to fire lifecycle events at appropriate points
TransferUtilityTests.cs	Added comprehensive test coverage for all lifecycle events including failure scenarios
433a9a6d-b8ea-4676-b763-70711e8288e2.json	Added dev config file marking this as a minor version change

[GarrettBeatty]

i put this here for consistency with the UploadProgress. i think technically its part of the Request (Request.FilePath). im open to removing this though