Added convenience helper to cancel and clear individual upload

Author: donnywals

Sources/TUSKit/TUSClient.swift

@@ -239,6 +239,18 @@ public final class TUSClient {
         scheduler.cancelTask(by: id)
     }
 
+    /// Cancel an upload and remove its cached data so it will not be retried on the next `start()`.
+    /// - Parameter id: The id of the upload to cancel and delete.
+    /// - Returns: `true` if a cached upload was found and deleted, `false` otherwise.
+    /// - Throws: File-related errors if the cache exists but cannot be removed.
+    @discardableResult
+    public func cancelAndDelete(id: UUID) throws -> Bool {
+        scheduler.cancelTask(by: id)
+        // Wait for the cancel request to be processed before deleting cached data.
+        scheduler.queue.sync { }
+        return try removeCacheFor(id: id)
+    }
+    
     /// This will cancel all running uploads and clear the local cache.
     /// Expect errors passed to the delegate for canceled tasks.
     /// - Warning: This method is destructive and will remove any stored cache.

Tests/TUSKitTests/TUSClient/TUSClientInternalTests.swift

@@ -22,11 +22,9 @@ final class TUSClientInternalTests: XCTestCase {
 
         do {
             relativeStoragePath = URL(string: "TUSTEST")!
-            
-            let docDir = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0]
-            fullStoragePath = docDir.appendingPathComponent(relativeStoragePath.absoluteString)
-            files = try Files(storageDirectory: fullStoragePath)
-            clearDirectory(dir: fullStoragePath)
+            files = try Files(storageDirectory: relativeStoragePath)
+            fullStoragePath = files.storageDirectory
+            clearDirectory(dir: files.storageDirectory)
 
             data = Data("abcdef".utf8)
 
@@ -124,6 +122,21 @@ final class TUSClientInternalTests: XCTestCase {
         }
     }
 
+    func testCancelAndDeleteRemovesCacheAndPreventsResume() throws {
+        let clientFiles = try Files(storageDirectory: relativeStoragePath)
+        let id = UUID()
+        let path = try clientFiles.store(data: data, id: id)
+        let metaData = UploadMetadata(id: id, filePath: path, uploadURL: URL(string: "io.tus")!, size: data.count, customHeaders: [:], mimeType: nil)
+        try clientFiles.encodeAndStore(metaData: metaData)
+        
+        let deleted = try client.cancelAndDelete(id: id)
+        XCTAssertTrue(deleted)
+        XCTAssertNil(try clientFiles.findMetadata(id: id))
+        
+        let resumed = client.start()
+        XCTAssertTrue(resumed.isEmpty)
+    }
+    
     func testCancellationDoesNotIncrementErrorCountOrRetry() throws {
         let metaData = try storeFiles()
         let creationTask = try CreationTask(metaData: metaData,