supabase / supabase-flutter / 28588548625

86%

push

github

feat(postgrest): add format option to explain() (#1516)

## What

Adds an `ExplainFormat` enum (`text`, `json`) and a `format` parameter
to `PostgrestTransformBuilder.explain()` (default `text`). The value is
interpolated into the `Accept` media type
(`application/vnd.pgrst.plan+<format>`), so a JSON plan can now be
requested.

## Why

SDK parity: supabase-js `explain({ format })` supports `'text' |
'json'`; the Dart client hardcoded `+text`.

## Tests

Added standalone mock-based unit tests asserting the `Accept` header for
the default text plan, an explicit JSON plan, and that other options are
still forwarded alongside the format.

Resolves SDK-1168

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

4203 of 4892 relevant lines covered (85.92%)

3.98 hits per line