feat(examples): showcase multipart, TUS resumable, and background downloads in Storage examples

[grdsdev]

Summary

• Adds backgroundDownloadSessionIdentifier to StorageOptions and threads it through SupabaseClient → StorageClientConfiguration, so apps using SupabaseClient can opt into background download sessions without needing a standalone StorageClient.
• Configures the Examples app with a background-download session identifier and wires application(_:handleEventsForBackgroundURLSession:completionHandler:) in AppDelegate to supabase.storage.handleBackgroundEvents(forSessionIdentifier:completionHandler:).
• Full rewrite of FileUploadView — showcases all three upload engines with real progress from the AsyncStream<TransferEvent> API:
  • Smart — auto-selects multipart (≤6 MB) or TUS (>6 MB)
  • Multipart — always multipart regardless of file size
  • Resumable (TUS) — live Pause / Resume / Cancel buttons backed by a retained StorageUploadTask
• Full rewrite of FileDownloadView — showcases both download paths with real progress:
  • To Memory (downloadData) — loads bytes in-process, image/text preview
  • To Disk (download) — saves to a temp file, background-session capable, noted in the UI
• Updated StorageExamplesView navigation rows to reflect the new capabilities.

Test plan

• Open the Examples app → Storage → Upload Files
  • Switch between Smart / Multipart / Resumable, upload a small (<6 MB) and large (>6 MB) file and confirm progress updates in real time.
  • In Resumable mode: tap Pause mid-upload and confirm the bar freezes; tap Resume and confirm it continues; tap Cancel and confirm state resets.
• Storage → Download Files
  • Switch between To Memory and To Disk, download an image and a text file; confirm preview appears for both modes.
  • In To Disk mode confirm the temporary file URL is displayed.
• Confirm the app compiles without warnings on iOS (make PLATFORM=IOS XCODEBUILD_ARGUMENT=build xcodebuild).

🤖 Generated with Claude Code

[grdsdev]

Code review

Found 2 issues:

1. FileDownloadView.swift and FileUploadView.swift are missing the Created by Author Name on DD/MM/YY. line from their file headers. AGENTS.md specifies the required format explicitly, and every other file in the Examples/ directory includes this line.

supabase-swift/Examples/Examples/Storage/FileDownloadView.swift

Lines 1 to 8 in a4ccb0b

	//
	// FileDownloadView.swift
	// Examples
	//
	// Demonstrates both download engines:
	// - To Memory (downloadData): loads file bytes in-process
	// - To Disk (download): saves to a temporary file; background-session capable, survives app suspension
	//

supabase-swift/Examples/Examples/Storage/FileUploadView.swift

Lines 1 to 9 in a4ccb0b

	//
	// FileUploadView.swift
	// Examples
	//
	// Demonstrates all three upload engines:
	// - Smart (auto): multipart for files ≤6 MB, TUS for larger files
	// - Multipart: standard HTTP multipart, always
	// - Resumable (TUS): pause / resume / cancel support, ideal for large files
	//

2. FileDownloadView reuses isDownloading for both loadFiles() (bucket file listing) and downloadFile() (actual transfer). This means tapping "Load Files" renders the "Downloading… 0%" progress bar and disables all download buttons while only fetching a directory listing. If a download is in progress and the user manually taps "Load Files", loadFiles()'s defer { isDownloading = false } will prematurely clear the flag and hide the transfer UI mid-download. A separate @State private var isLoadingFiles = false flag in loadFiles() would fix both problems.

supabase-swift/Examples/Examples/Storage/FileDownloadView.swift

Lines 62 to 65 in a4ccb0b

	if isDownloading {
	transferSection
	}

supabase-swift/Examples/Examples/Storage/FileDownloadView.swift

Lines 228 to 236 in a4ccb0b

	do {
	error = nil
	isDownloading = true
	defer { isDownloading = false }
	files = try await supabase.storage.from(selectedBucket).list()
	} catch {
	self.error = error
	}
	}

🤖 Generated with Claude Code

_{- If this code review was useful, please react with 👍. Otherwise, react with 👎.}