feat(storage_client): support copy/move to different bucket

Author: Vinzent03

packages/storage_client/lib/src/storage_file_api.dart

@@ -276,14 +276,21 @@ class StorageFileApi {
   /// example `folder/image.png`.
   /// [toPath] is the new file path, including the new file name. For example
   /// `folder/image-new.png`.
-  Future<String> move(String fromPath, String toPath) async {
+  ///
+  /// When copying to a different bucket, you have to specify the [destinationBucket].
+  Future<String> move(
+    String fromPath,
+    String toPath, {
+    String? destinationBucket,
+  }) async {
     final options = FetchOptions(headers: headers);
     final response = await _storageFetch.post(
       '$url/object/move',
       {
         'bucketId': bucketId,
         'sourceKey': fromPath,
         'destinationKey': toPath,
+        if (destinationBucket != null) 'destinationBucket': destinationBucket,
       },
       options: options,
     );
@@ -297,14 +304,21 @@ class StorageFileApi {
   ///
   /// [toPath] is the new file path, including the new file name. For example
   /// `folder/image-copy.png`.
-  Future<String> copy(String fromPath, String toPath) async {
+  ///
+  /// When copying to a different bucket, you have to specify the [destinationBucket].
+  Future<String> copy(
+    String fromPath,
+    String toPath, {
+    String? destinationBucket,
+  }) async {
     final options = FetchOptions(headers: headers);
     final response = await _storageFetch.post(
       '$url/object/copy',
       {
         'bucketId': bucketId,
         'sourceKey': fromPath,
         'destinationKey': toPath,
+        if (destinationBucket != null) 'destinationBucket': destinationBucket,
       },
       options: options,
     );

packages/storage_client/test/client_test.dart

@@ -388,5 +388,51 @@ void main() {
 
       await storage.from(newBucketName).copy(uploadPath, "$uploadPath 2");
     });
+
+    test('copy to different bucket', () async {
+      final storage = SupabaseStorageClient(
+          storageUrl, {'Authorization': 'Bearer $storageKey'});
+
+      try {
+        await storage.from('bucket2').download(uploadPath);
+        fail('File that does not exist was found');
+      } on StorageException catch (error) {
+        expect(error.error, 'not_found');
+      }
+      await storage
+          .from(newBucketName)
+          .copy(uploadPath, uploadPath, destinationBucket: 'bucket2');
+      try {
+        await storage.from('bucket2').download(uploadPath);
+      } catch (error) {
+        fail('File that was copied was not found');
+      }
+    });
+
+    test('move to different bucket', () async {
+      final storage = SupabaseStorageClient(
+          storageUrl, {'Authorization': 'Bearer $storageKey'});
+
+      try {
+        await storage.from('bucket2').download('$uploadPath 3');
+        fail('File that does not exist was found');
+      } on StorageException catch (error) {
+        expect(error.error, 'not_found');
+      }
+      await storage
+          .from(newBucketName)
+          .move(uploadPath, '$uploadPath 3', destinationBucket: 'bucket2');
+      try {
+        await storage.from('bucket2').download('$uploadPath 3');
+      } catch (error) {
+        fail('File that was moved was not found');
+      }
+      try {
+        await storage.from(newBucketName).download(uploadPath);
+        fail('File that was moved was found');
+      } on StorageException catch (error) {
+        expect(error.error, 'not_found');
+      }
+    });
   });
 }