supabase / supabase-flutter / 28651454686

86%

push

github

feat(storage): add download option to signed and public URLs (#1514)

## What

Adds an optional `download` parameter to:

- `createSignedUrl`
- `createSignedUrlsResult` (and the deprecated `createSignedUrls`)
- `getPublicUrl`

Passing `true` appends `download=` so the CDN serves the file with a
`Content-Disposition: attachment` header using its original name;
passing a `String` overrides the download file name. `null`/`false`
leave the URL unchanged.

## Why

SDK parity: supabase-js accepts `download?: string | boolean` on these
methods. The Dart client had no way to force a download.

## Tests

- Mock-based unit tests cover `getPublicUrl` (original name, custom
name, disabled) and the signed-URL methods (appending `&download=` after
the existing `?token=` query).
- An end-to-end test uploads to a public bucket, then fetches the signed
and public URLs and asserts the real `Content-Disposition: attachment`
response header.

## Compliance

Marks `create_signed_url`, `create_signed_urls`, and `get_public_url`
implemented in `sdk-compliance.yaml`.

Resolves SDK-1166

13 of 13 new or added lines in 2 files covered. (100.0%)

4230 of 4916 relevant lines covered (86.05%)

4.0 hits per line