supabase / supabase-flutter / 29099122685

87%

push

github

feat(storage): add cacheNonce parameter for cache invalidation (#1578)

## Summary

Adds an optional `cacheNonce` parameter to the URL-generating storage
methods so callers can bypass CDN caching for a specific file version.
When set, a `cacheNonce` query parameter is appended to the generated
URL.

Methods updated:
- `getPublicUrl`
- `createSignedUrl`
- `createSignedUrls` / `createSignedUrlsResult`
- `download`

**Outcome:** implemented
**Ticket:** SDK-875
**Reference:** supabase-js PR #2234 (`1ec22ca5`)
**Compliance matrix:** `storage.file_buckets.url_cache_nonce` →
implemented

## Notes
- New optional named parameter, so no breaking changes and no new public
symbols.
- Unit tests added for `getPublicUrl`, `download`, `createSignedUrl`,
and `createSignedUrlsResult` with `cacheNonce` (including ordering after
`download`).

## Stacking
First of three stacked PRs for the remaining Storage file-bucket
features. Base: `main`.

14 of 14 new or added lines in 1 file covered. (100.0%)

4670 of 5364 relevant lines covered (87.06%)

4.05 hits per line