feat(storage): add purgeBucketCache to invalidate CDN cache for a whole bucket

[spydon]

Summary

Adds StorageBucketApi.purgeBucketCache(id, {transformations}) to invalidate the CDN cache for every object in a bucket. Issues DELETE /cdn/{bucket} against the storage base URL and returns the server's success message. When transformations is true, only the resized/formatted variants are purged, leaving the original cached objects intact; otherwise the bucket cache is purged.

Requires the service-role key and the tenant purgeCache feature enabled on the storage server.

Stacked on top of #1607 (SDK-1331, object-level purge). Base this PR against main once #1607 merges.

Outcome: implemented

Reference: supabase-js PR #2429 (storage.file_buckets.purge_bucket_cache)

Compliance matrix

• storage.file_buckets.purge_bucket_cache → implemented (symbol StorageBucketApi.purgeBucketCache)

Tests

Added unit tests in packages/storage_client/test/basic_test.dart covering the DELETE endpoint/URL and the transformations query parameter.

SDK-1332

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

🗂️ Base branches to auto review (1)

• develop

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.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 886e5882-bbd0-44ae-9203-78029ada56bb

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

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

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.}