Recached

supabase / supabase-flutter
85%

DEFAULT BRANCH: main
Repo Added
Token z3GUkNtD1PDnCOWpuPvCMvjUB924F4R9N regen
Build 769 Last
Files 80
Badge
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst

LAST BUILD ON BRANCH main
branch: SELECT
CHANGE BRANCH
x
Sync Branches

coverage: 85.464% (+0.1%) from 85.368%
28190414303

push

github

web-flow 
fix(realtime): surface async postgres_changes system error as channelError (#1470)

## Summary

Fixes #1466.

A `postgres_changes` channel can report
`RealtimeSubscribeStatus.subscribed` and stay joined while delivering
**zero** events, indefinitely, when the server-side replication
subscription fails *after* the phoenix join succeeds. The failure is
delivered as an asynchronous `system` event with `status: error`, but
the SDK only exposes that via `onSystemEvents(...)` (documented "for
debugging purposes") and never forwards it to the `.subscribe()` status
callback — a silent "zombie" channel: green/connected to the app, but
dead.

This is especially painful on reconnect/resume flows where the access
token may be stale (e.g. the refresh timer was throttled while the app
was idle/backgrounded). The channel re-subscribes, the join succeeds,
the app marks it healthy, and it silently delivers nothing until the
next reconnect. It bit us as a user-facing incident: live data silently
stopped updating after a reconnect.

## Root cause

`postgres_changes` is an extension whose replication subscription is set
up asynchronously by the server, *after* the channel join.
`.subscribe()`'s status is driven by the phoenix join
(`joined/errored/closed/timeout`), and there is no
`RealtimeSubscribeStatus` value for "joined, but the extension
subscription failed." The join reply optimistically echoes the requested
`postgres_changes` config (with server-assigned binding ids), so binding
reconciliation succeeds and `subscribed` fires *before* the replication
is confirmed live. The real verdict arrives on a later `system
status=error` event, which the high-level API drops on the floor.

Wire sequence with a **stale/expired** token (`auth.uid()` no longer
satisfies the policy):

```
<- phx_reply   status=ok    response={postgres_changes:[{id, event:INSERT, schema, table, filter}]}
   // subscribe() callback fires RealtimeSubscribeStatus.subscribed here
<- system      status=... (continued)

4 of 4 new or added lines in 1 file covered. (100.0%)

4098 of 4795 relevant lines covered (85.46%)

3.64 hits per line

Relevant lines Covered
4795 RELEVANT LINES 4098 COVERED LINES
3.64 HITS PER LINE
Source Files on main

Recent builds

Builds Branch Commit Type Ran Committer Via Coverage
28190414303 main fix(realtime): surface async postgres_changes system error as channelError (#1470) ## Summary Fixes #1466. A `postgres_changes` channel can report `RealtimeSubscribeStatus.subscribed` and stay joined while delivering **zero** events, indefinite... push web-flow github
85.46
28183511985 fix/realtime-postgres-changes-system-error Merge 9cf0df723 into 33402e80f Pull #1470 web-flow github
85.46
28180404069 fix/realtime Merge 1d25932f1 into 33402e80f Pull #1471 web-flow github
86.73
28179684443 fix/realtime Merge 0462b418b into 33402e80f Pull #1471 web-flow github
85.33
28177869575 main fix(gotrue): include code challenge in resend with PKCE flow (#1469) ## What When `resend()` is called with an `email` while the client uses the PKCE flow (the default), the `POST /resend` request now includes `code_challenge` and `code_challeng... push web-flow github
85.37
28173559566 fix/realtime-postgres-changes-system-error Merge b324ebd27 into ba67347d6 Pull #1470 web-flow github
85.46
28163284198 lukasklingsbo/sdk-1023-parityauth-resend-with-pkce-flow-should-include Merge fcfd10a5e into ba67347d6 Pull #1469 web-flow github
85.37
28161141238 lukasklingsbo/sdk-1018-httpsend-per-event-url Merge f451d046c into ba67347d6 Pull #1467 web-flow github
85.39
28160997993 lukasklingsbo/sdk-1020-parityauth-verifyotp-for-email_change-returns-null Merge 57e99f248 into ba67347d6 Pull #1468 web-flow github
85.37
28160934733 lukasklingsbo/sdk-1018-httpsend-per-event-url Merge 87119d88d into ba67347d6 Pull #1467 web-flow github
85.0
See All Builds (768)

Badge your Repo: supabase-flutter

We detected this repo isn’t badged! Grab the embed code to the right, add it to your repo to show off your code coverage, and when the badge is live hit the refresh button to remove this message.
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst

Refresh