supabase / supabase-flutter / 29415982262

87%

push

github

feat(storage): add analytics (Iceberg) bucket CRUD (#1588)

## Summary

Adds support for analytics (Apache Iceberg) buckets to `storage_client`,
covering the bucket lifecycle: create, list, and delete. These map to
the storage server's Iceberg bucket endpoints under `/iceberg/bucket`.

New public API on the storage bucket client:
- `createAnalyticsBucket(String id)` → `AnalyticsBucket` — `POST
/iceberg/bucket`
- `listAnalyticsBuckets([ListBucketsOptions options])` →
`List<AnalyticsBucket>` — `GET /iceberg/bucket`
- `deleteAnalyticsBucket(String id)` → `String` — `DELETE
/iceberg/bucket/:name`

Listing reuses the existing `ListBucketsOptions`
(limit/offset/search/sortColumn/sortOrder), matching the file bucket
listing API. A new `AnalyticsBucket` type models the response (`id`,
`name`, `createdAt`, `updatedAt`).

## Scope

This PR covers the analytics **bucket** capabilities only. The Iceberg
REST Catalog operations (namespaces and tables) are a much larger
surface (a standalone `iceberg-js`-equivalent client) and are tracked as
a follow-up in SDK-1309.

## Outcome

`implemented` for:
- `storage.analytics.create_analytics_bucket`
- `storage.analytics.list_analytics_buckets`
- `storage.analytics.delete_analytics_bucket`

## Tests

Added unit tests in `basic_test.dart` (mock HTTP client) verifying
request method/path/body and response parsing for all three methods.
Full `storage_client` mock test suite passes.

## Reference

Supabase Storage server Iceberg bucket routes
(`src/http/routes/iceberg/bucket.ts`). In supabase-js the analytics
bucket API is not yet in the storage client; the Iceberg catalog lives
in the standalone `supabase/iceberg-js` package.

## Compliance matrix

`sdk-compliance.yaml`: the three capabilities above → `implemented`,
with new public symbols registered.

Part of SDK-1308.

447 of 652 new or added lines in 8 files covered. (68.56%)

5537 of 6380 relevant lines covered (86.79%)

3.92 hits per line