solidjs / solid / 36117124364

74%

main: 89%

push

github

Stage 8 Phase A: live over event streams — response lifetime, per-scope takeover, chaos knob, room demo (#3653)

* docs: Stage 8 — live is one event-stream response per source; nothing to configure

Settles the server-components "connection-shaped transport" stage as a
framing note rather than a transport: each `live` source keeps its own
connection (today's shape) and the response is framed as server-sent
events (text/event-stream, no-store, X-Accel-Buffering: no, one codec
payload per data: event, comment heartbeat), with Last-Event-ID as
position (cursor, or a server-issued digest of the last value) and a
terminal record on both framings so death and completion are distinct.
The precondition is a backend that holds connections over HTTP/2; dev
warns past five live connections over HTTP/1.1. There is no client
declaration and no server configuration.

RFC 10 gains the `live(fn)` extension surface: lifetime is the
response's (nested async sources are branded live and reconnect
together), reconnect re-yields the whole answer, SSR hands off at first
settlement per hydration scope, undeclared death is an error, hidden
pages pause after a grace window with status held through the pause.
The transport detour (per-page channel and mailbox, `transport` enum,
`hold`, SSE(fn), enableEventStream(), Accept as declaration,
framing-follows-method) is recorded under Alternatives considered.

§9.5 is rewritten around the same decisions with frames consuming
`live` rather than mirroring it; roadmap bullet 8, the §9.3 seed
pointer, and the §9.4 grouping seed (which cited a Stage 8 shared
connection that no longer exists; see discussion #3603) are corrected.

Two shipped-behavior findings are flagged for the implementation:
`armLiveTakeover` gates on page-wide hydration end where the snapshot
design is per boundary scope (fix: key the gate per scope owner), and
`live` will pause on hidden pages.

plans/stage8-connection-transport.md carries the phased plan (A: data
ti... (continued)

620 of 907 branches covered (68.36%)

Branch coverage included in aggregate %.

45 of 52 new or added lines in 3 files covered. (86.54%)

917 of 1174 relevant lines covered (78.11%)

27.17 hits per line