feat: add jobId-based cancellation for upload and download operations

[patrickkabwe]

Summary

This PR adds support for cancelling upload and download operations by returning a jobId from both uploadFile and downloadFile methods.

Usage Example

// Upload with cancellation
const uploadJobId = await NitroFS.uploadFile(file, options, (uploaded, total) => {
  console.log(`Progress: ${uploaded / total * 100}%`)
})
// Cancel if needed
const cancelled = await NitroFS.cancelUpload(uploadJobId)

// Download with cancellation
const { jobId, file } = await NitroFS.downloadFile(url, destPath, (downloaded, total) => {
  console.log(`Progress: ${downloaded / total * 100}%`)
})
// Cancel if needed (before completion)
const cancelled = await NitroFS.cancelDownload(jobId)

Testing

• Test upload cancellation
• Test download cancellation
• Test concurrent uploads/downloads
• Test progress callbacks work correctly
• Test error handling

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feat/upload-download-cancellation

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}