supabase / supabase-flutter / 29080142790

87%

push

github

feat(storage): support filter/sort/pagination options on listBuckets() (#1557)

## Summary

Adds optional filter, sort, and pagination arguments to
`StorageBucketApi.listBuckets()`, matching the supabase-js options.
Calling `listBuckets()` with no arguments keeps the current behavior, so
this is non-breaking.

The new `ListBucketsOptions` supports `limit`, `offset`, `search`,
`sortColumn` (`BucketSortColumn`), and `sortOrder` (`BucketSortOrder`).
These are serialized into the `bucket` request query string (`limit`,
`offset`, `search`, `sortColumn`, `sortOrder`), mirroring the JS
`listBucketOptionsToQueryString` behavior.

**Outcome:** implemented

## Reference

supabase-js `StorageBucketApi.listBuckets(options?: ListBucketOptions)`
in `packages/core/storage-js/src/packages/StorageBucketApi.ts`.

## Compliance matrix

`storage.file_buckets.list_file_buckets` → `implemented` (was
`partially_implemented`).

## Tests

Added mock-http-client tests in
`packages/storage_client/test/basic_test.dart` covering: no options (no
query string), empty options, all options set, and `limit`/`offset` of
zero. `dart analyze` and the storage_client mock tests pass.

Linear: SDK-1271

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>

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

4601 of 5304 relevant lines covered (86.75%)

4.03 hits per line