supabase / supabase-flutter / 40331848863

94%

push

github

feat(supabase)!: run the typed table requests through client interceptors (#1940)

## What

Reference implementation of [RFC: Client interceptor seam for the
SDKs](https://linear.app/supabase/project/rfc-client-interceptor-seam-for-the-sdks-cf968a76040c),
and milestone 1 of [RFC: Pluggable offline support for the client
SDKs](https://linear.app/supabase/project/rfc-pluggable-offline-support-for-the-client-sdks-3a492e9035f4),
tracked in [SDK-1886](https://linear.app/supabase/issue/SDK-1886).

The typed table builders collected filters, orderings, column
expressions and payloads as values but rendered them into URL parameters
on every step. Nothing could run a typed query anywhere but PostgREST
without parsing those URLs back, and the only extension point,
`httpClient`, sits inside `AuthHttpClient`, so a request held back and
replayed later carries a stale token.

### postgrest

- `PostgrestTableRequest`: the immutable value the typed builders now
accumulate (table, schema, operation, columns, filter, orderings, limit,
offset, embedded pages, result shape, count option, payload, upsert
options, `maxAffected`, `stripNulls`, `dryRun`, explain options).
- `PostgrestTableResult`: decoded data plus count, converted into the
table's row type by the builder.
- `PostgrestTableExecutor` and `PostgrestHttpTableExecutor`. The HTTP
executor renders the value through the untyped builders, so the
parameters and headers on the wire are the ones `from()` produces for
the same query. `PostgrestClient.table(table, executor:)` accepts
another executor.
- An interceptor's `pause()` and `resume()` are not awaited by the
Flutter lifecycle listener, so a slow or failing interceptor cannot
delay or skip the realtime reconnect; a failing `dispose()` is logged
and does not abort the client disposal.
- `PostgrestTypedBuilder.request` exposes the collected value.

### supabase

- `SupabaseClientInterceptor` with `wrapTableExecutor`, `attach`,
`pause`, `resume` and `dispose`, and `... (continued)

91 of 106 new or added lines in 12 files covered. (85.85%)

12122 of 12886 relevant lines covered (94.07%)

6.35 hits per line