rxfy-client

The framework-agnostic browser sync runtime for rxfy — channel grant custody plus the sync update sink. rxfy-react builds on this; use it directly from vanilla JS, Vue, Svelte, or any other view layer.

Channel grants

There are no server-held sessions. Each served state payload carries a stateless signed JWT channel grant on a reserved $grant field. The client takes custody of every grant, sends a subscribe frame carrying it plus the entity topics its payload normalized into, and renews grants near expiry against an app-mounted endpoint.

• Grants arrive automatically: useStateData lifts $grant off each fetch result and hands it to the sync client — zero integrator plumbing.
• readSsrGrants(): string[] — lifts the SSR grants array embedded in the hydration payload, for grants that came down with a server-rendered page.
• The API client is now plain hc<AppType>("/api") — no session headers, no fetch wrapping. Sync subscriptions ride the $grant in the payload, so the fetch client carries nothing.

Sync client

createSyncClient({ registry, transport, renewUrl? }) is a patch/stale sink plus grant custody: patches land in the model stores in place, stales bump channel counters, and it manages the subscribe/renew/replay lifecycle for its grants. Its only outbound frame is subscribe. Near expiry it POSTs the expiring grants to renewUrl and re-subscribes with the reissued grants; omit renewUrl to let grants simply expire. On reconnect it replays its whole grant set.

import { createSyncClient, readSsrGrants } from "rxfy-client";
import { createWsClient } from "rxfy-ws/client";

const live = createSyncClient({
  registry,
  transport: createWsClient({ url: `wss://${location.host}/live` }),
  renewUrl: "/api/live/renew",
});

See the rxfy-client docs — createSyncClient and readSsrGrants — plus Sync Client in React and Grants.