fix(storage): Resolve MultipartRequest finalization error in retry mechanism (#1208)

When using StorageRetryController, failed uploads would trigger retries that attempted to reuse the same MultipartRequest object. Since MultipartRequest objects become finalized after the first send() call, subsequent retry attempts would throw "Can't finalize a finalized Request" StateError.

This fix creates a fresh MultipartRequest for each retry attempt by introducing a createRequest() factory function that generates new request objects with all the necessary headers, files, and fields configured correctly.

Fixes the retry functionality for file uploads with StorageRetryController, making it reliable for handling network failures during large file uploads.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-authored-by: Claude <[email protected]>

Author: grdsdev

packages/storage_client/lib/src/fetch.dart

@@ -159,16 +159,21 @@ class Fetch {
     StorageRetryController? retryController,
   ) async {
     final headers = options?.headers ?? {};
-    final request = http.MultipartRequest(method, Uri.parse(url))
-      ..headers.addAll(headers)
-      ..files.add(multipartFile)
-      ..fields['cacheControl'] = fileOptions.cacheControl
-      ..headers['x-upsert'] = fileOptions.upsert.toString();
-    if (fileOptions.metadata != null) {
-      request.fields['metadata'] = json.encode(fileOptions.metadata);
-    }
-    if (fileOptions.headers != null) {
-      request.headers.addAll(fileOptions.headers!);
+
+    // Create a factory function that generates a fresh MultipartRequest for each attempt
+    http.MultipartRequest createRequest() {
+      final request = http.MultipartRequest(method, Uri.parse(url))
+        ..headers.addAll(headers)
+        ..files.add(multipartFile)
+        ..fields['cacheControl'] = fileOptions.cacheControl
+        ..headers['x-upsert'] = fileOptions.upsert.toString();
+      if (fileOptions.metadata != null) {
+        request.fields['metadata'] = json.encode(fileOptions.metadata);
+      }
+      if (fileOptions.headers != null) {
+        request.headers.addAll(fileOptions.headers!);
+      }
+      return request;
     }
 
     final http.StreamedResponse streamedResponse;
@@ -178,6 +183,10 @@ class Fetch {
       () async {
         attempts++;
         _log.finest('Request: attempt: $attempts $method $url $headers');
+
+        // Create a fresh request for each retry attempt
+        final request = createRequest();
+
         if (httpClient != null) {
           return httpClient!.send(request);
         } else {