supabase / supabase-flutter / 28254051980

86%

push

github

feat(realtime): update httpSend to per-event broadcast URL with binary support (#1467)

## What

Brings `RealtimeChannel.httpSend()` to parity with supabase-js
([supabase/supabase-js#2400](https://github.com/supabase/supabase-js/pull/2400)).

- Uses the new per-event URL format `POST
/api/broadcast/{topic}/events/{event}` instead of the old `POST
/api/broadcast` with a `messages` array wrapper.
- Adds `?private=true` query parameter for private channels.
- URL-encodes the topic and event names.
- Sends the payload directly (no `messages` wrapper).
- `TypedData` (e.g. `Uint8List`) and `ByteBuffer` payloads are sent as
`application/octet-stream`; everything else is JSON-encoded.
- Returns a clearer error when the server responds with 404 (server too
old).

The implicit REST fallback in `send()` is intentionally left on the old
format, matching supabase-js, which only changed `httpSend()`.

## Compatibility

- The `payload` parameter type widens from `Map<String, dynamic>` to
`Object` to allow binary payloads. This is backward compatible: existing
calls passing a map still compile.
- The new endpoint requires Realtime server **v2.97.0+**
([supabase/realtime#1864](https://github.com/supabase/realtime/pull/1864)).
This matches supabase-js, which shipped the same change as a minor
`feat`.

## Test plan

- Updated `httpSend` tests for the new URL format and direct payload
body.
- Added tests for the `private` query parameter (present for private,
absent for public), URL-encoding of special characters, and
`Uint8List`/`ByteBuffer` binary payloads.

Closes SDK-1018

18 of 19 new or added lines in 1 file covered. (94.74%)

4121 of 4812 relevant lines covered (85.64%)

3.69 hits per line