feat: implement partially method copy

Author: diegofesanto

Storage/DestinationOptions.cs

@@ -0,0 +1,12 @@
+namespace Supabase.Storage;
+
+/// <summary>
+/// Represents the options for a destination in the context of Supabase Storage.
+/// </summary>
+public class DestinationOptions
+{
+    /// <summary>
+    /// Gets or sets the name of the destination bucket in the context of Supabase Storage.
+    /// </summary>
+    public string? DestinationBucket { get; set; }
+}

Storage/Exceptions/FailureHint.cs

@@ -27,6 +27,8 @@ 400 when storageException.Content.ToLower().Contains("malformed") => NotAuthoriz
                     400 when storageException.Content.ToLower().Contains("invalid signature") => NotAuthorized,
 	                400 when storageException.Content.ToLower().Contains("invalid") => InvalidInput,
     				401 => NotAuthorized,
+				    403 when storageException.Content.ToLower().Contains("invalid compact jws") => NotAuthorized,
+				    403 when storageException.Content.ToLower().Contains("signature verification failed") => NotAuthorized,
                     404 when storageException.Content.ToLower().Contains("not found") => NotFound,
 	                409 when storageException.Content.ToLower().Contains("exists") => AlreadyExists,
     				500 => Internal,

Storage/Interfaces/IStorageFileApi.cs

@@ -18,7 +18,8 @@ public interface IStorageFileApi<TFileObject>
 		Task<string> DownloadPublicFile(string supabasePath, string localPath, TransformOptions? transformOptions = null, EventHandler<float>? onProgress = null);
         string GetPublicUrl(string path, TransformOptions? transformOptions = null);
 		Task<List<TFileObject>?> List(string path = "", SearchOptions? options = null);
-		Task<bool> Move(string fromPath, string toPath);
+		Task<bool> Move(string fromPath, string toPath, DestinationOptions? options = null);
+		Task<bool> Copy(string fromPath, string toPath, DestinationOptions? options = null);
         Task<TFileObject?> Remove(string path);
 		Task<List<TFileObject>?> Remove(List<string> paths);
         Task<string> Update(byte[] data, string supabasePath, FileOptions? options = null, EventHandler<float>? onProgress = null);

Storage/StorageFileApi.cs

@@ -281,23 +281,46 @@ public Task<string> Update(byte[] data, string supabasePath, FileOptions? option
         }
 
         /// <summary>
-        /// Moves an existing file, optionally renaming it at the same time.
+        /// Moves an existing file to a new location, optionally allowing renaming.
         /// </summary>
-        /// <param name="fromPath">The original file path, including the current file name. For example `folder/image.png`.</param>
-        /// <param name="toPath">The new file path, including the new file name. For example `folder/image-copy.png`.</param>
-        /// <returns></returns>
-        public async Task<bool> Move(string fromPath, string toPath)
+        /// <param name="fromPath">The original file path, including the current file name (e.g., `folder/image.png`).</param>
+        /// <param name="toPath">The target file path, including the new file name (e.g., `folder/image-copy.png`).</param>
+        /// <param name="options">Optional parameters for specifying the destination bucket and other settings.</param>
+        /// <returns>Returns a boolean value indicating whether the operation was successful.</returns>
+        public async Task<bool> Move(string fromPath, string toPath, DestinationOptions? options = null)
         {
             var body = new Dictionary<string, string?>
             {
                 { "bucketId", BucketId },
                 { "sourceKey", fromPath },
-                { "destinationKey", toPath }
+                { "destinationKey", toPath },
+                { "destinationBucket", options?.DestinationBucket }
             };
             await Helpers.MakeRequest<GenericResponse>(HttpMethod.Post, $"{Url}/object/move", body, Headers);
             return true;
         }
 
+        /// <summary>
+        /// Copies a file/object from one path to another within a bucket or across buckets.
+        /// </summary>
+        /// <param name="fromPath">The source path of the file/object to copy.</param>
+        /// <param name="toPath">The destination path for the copied file/object.</param>
+        /// <param name="options">Optional parameters such as the destination bucket.</param>
+        /// <returns>True if the copy operation was successful.</returns>
+        public async Task<bool> Copy(string fromPath, string toPath, DestinationOptions? options = null)
+        {
+            var body = new Dictionary<string, string?>
+            {
+                { "bucketId", BucketId },
+                { "sourceKey", fromPath },
+                { "destinationKey", toPath },
+                { "destinationBucket", options?.DestinationBucket }
+            };
+
+            await Helpers.MakeRequest<GenericResponse>(HttpMethod.Post, $"{Url}/object/copy", body, Headers);
+            return true;
+        }
+
         /// <summary>
         /// Downloads a file from a private bucket. For public buckets, use <see cref="DownloadPublicFile(string, string, TransformOptions?, EventHandler{float}?)"/>
         /// </summary>

StorageTests/Helpers.cs

@@ -5,9 +5,9 @@ namespace StorageTests
 {
     public static class Helpers
     {
-        public static string SupabaseUrl => "http://localhost:5000";
-        public static string ServiceKey => "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyb2xlIjoic2VydmljZV9yb2xlIiwiaWF0IjoxNjEzNTMxOTg1LCJleHAiOjE5MjkxMDc5ODV9.th84OKK0Iz8QchDyXZRrojmKSEZ-OuitQm_5DvLiSIc";
-        public static string PublicKey => "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJhdXRoZW50aWNhdGVkIiwic3ViIjoiMzE3ZWFkY2UtNjMxYS00NDI5LWEwYmItZjE5YTdhNTE3YjRhIiwiZW1haWwiOiJpbmlhbit0ZXN0MUBzdXBhYmFzZS5pbyIsImV4cCI6MTkzOTEwNzk4NSwiYXBwX21ldGFkYXRhIjp7InByb3ZpZGVyIjoiZW1haWwifSwidXNlcl9tZXRhZGF0YSI6e30sInJvbGUiOiJhdXRoZW50aWNhdGVkIn0.E-x3oYcHIjFCdUO1M3wKDl1Ln32mik0xdHT2PjrvN70";
+        public static string SupabaseUrl => "http://127.0.0.1:54321/storage/v1";
+        public static string PublicKey => "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24iLCJleHAiOjE5ODM4MTI5OTZ9.CRXP1A7WOeoJeXxjNni43kdQwgnWNReilDMblYTn_I0";
+        public static string ServiceKey => "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6InNlcnZpY2Vfcm9sZSIsImV4cCI6MTk4MzgxMjk5Nn0.EGIM96RAZx35lJzdJsyH-qQwv8Hdp7fsn3W0YpN81IU";
 
         public static string StorageUrl => $"{SupabaseUrl}";
 

StorageTests/StorageFileAnonTests.cs

@@ -28,7 +28,7 @@ public async Task InitializeTest()
 
         if (_bucket == null && await Storage.GetBucket(_bucketId) == null)
         {
-            await AdminStorage.CreateBucket(_bucketId, new BucketUpsertOptions { Public = true });
+            await AdminStorage.CreateBucket(_bucketId, new BucketUpsertOptions { Public = false });
         }
 
         _adminBucket = AdminStorage.From(_bucketId);
@@ -131,6 +131,18 @@ await Assert.ThrowsExceptionAsync<SupabaseStorageException>(async () =>
         });
     }
 
+    [TestMethod("File: Throws attempting to Copy")]
+    public async Task Copy()
+    {
+        var name = $"{Guid.NewGuid()}.bin";
+        await _adminBucket.Upload(new Byte[] { 0x0, 0x1 }, name);
+
+        await Assert.ThrowsExceptionAsync<SupabaseStorageException>(async () =>
+        {
+            await _bucket.Copy(name, "new-file.bin");
+        });
+    }
+    
     [TestMethod("File: Get Public Link")]
     public async Task GetPublicLink()
     {

StorageTests/StorageFileTests.cs

@@ -155,6 +155,20 @@ public async Task Move()
         Assert.IsNotNull(items.Find((f) => f.Name == "new-file.bin"));
         Assert.IsNull(items.Find((f) => f.Name == name));
     }
+    
+    [TestMethod("File: Copy")]
+    public async Task Copy()
+    {
+        var name = $"{Guid.NewGuid()}.bin";
+        await _bucket.Upload([0x0, 0x1], name);
+        await _bucket.Copy(name, "new-file.bin");
+        var items = await _bucket.List();
+
+        Assert.IsNotNull(items);
+
+        Assert.IsNotNull(items.Find((f) => f.Name == "new-file.bin"));
+        Assert.IsNotNull(items.Find((f) => f.Name == name));
+    }
 
     [TestMethod("File: Get Public Link")]
     public async Task GetPublicLink()

supabase/.gitignore

@@ -0,0 +1,8 @@
+# Supabase
+.branches
+.temp
+
+# dotenvx
+.env.keys
+.env.local
+.env.*.local