feat(sftp): add SFTPv3 protocol support (#2875)

Co-authored-by: houseme <housemecn@gmail.com>

crates/protocols/src/common/client/s3.rs

@@ -71,4 +71,64 @@ pub trait StorageBackend: Send + Sync {
     async fn create_bucket(&self, bucket: &str, access_key: &str, secret_key: &str) -> Result<CreateBucketOutput, Self::Error>;
     /// Delete a bucket (must be empty)
     async fn delete_bucket(&self, bucket: &str, access_key: &str, secret_key: &str) -> Result<DeleteBucketOutput, Self::Error>;
+    /// Server-side copy of an object from one bucket+key to another.
+    /// The input carries the full S3 surface (content type, metadata map,
+    /// metadata directive, storage class, SSE config, conditional-copy
+    /// headers) so protocol drivers can map client-supplied metadata
+    /// onto the destination object.
+    async fn copy_object(
+        &self,
+        input: CopyObjectInput,
+        access_key: &str,
+        secret_key: &str,
+    ) -> Result<CopyObjectOutput, Self::Error>;
+    /// Initiate a multipart upload. Returns an upload_id that identifies
+    /// the in-progress upload for subsequent UploadPart, CompleteMultipartUpload,
+    /// and AbortMultipartUpload calls. The input carries the full S3 surface
+    /// (content type, cache control, metadata map, storage class, SSE config,
+    /// object lock settings) so protocol drivers can map client-supplied
+    /// metadata into the upload at creation time.
+    async fn create_multipart_upload(
+        &self,
+        input: CreateMultipartUploadInput,
+        access_key: &str,
+        secret_key: &str,
+    ) -> Result<CreateMultipartUploadOutput, Self::Error>;
+    /// Upload one part of a multipart upload. The part_number must be in
+    /// the range 1 to the 10 000-part S3 limit. The returned ETag
+    /// identifies the part in the subsequent CompleteMultipartUpload call.
+    async fn upload_part(
+        &self,
+        input: UploadPartInput,
+        access_key: &str,
+        secret_key: &str,
+    ) -> Result<UploadPartOutput, Self::Error>;
+    /// Assemble the parts listed in the input into the final object.
+    /// The parts list must be sorted by part_number with no duplicates.
+    async fn complete_multipart_upload(
+        &self,
+        input: CompleteMultipartUploadInput,
+        access_key: &str,
+        secret_key: &str,
+    ) -> Result<CompleteMultipartUploadOutput, Self::Error>;
+    /// Abort an in-progress multipart upload. Releases any storage
+    /// associated with the upload_id. Idempotent: calling abort on an
+    /// already-aborted upload_id returns success. The input carries the
+    /// cross-account and conditional-abort fields (expected_bucket_owner,
+    /// if_match_initiated_time) that non-SFTP consumers may need.
+    async fn abort_multipart_upload(
+        &self,
+        input: AbortMultipartUploadInput,
+        access_key: &str,
+        secret_key: &str,
+    ) -> Result<AbortMultipartUploadOutput, Self::Error>;
+    /// Copy a byte range from an existing object into a part of an
+    /// in-progress multipart upload. Used by rename for objects larger
+    /// than the 5 GiB single-shot CopyObject limit.
+    async fn upload_part_copy(
+        &self,
+        input: UploadPartCopyInput,
+        access_key: &str,
+        secret_key: &str,
+    ) -> Result<UploadPartCopyOutput, Self::Error>;
 }