This package provides support for bi-directional communication through Server Sent Events and corresponding POST requests.
This package is not intended to be a general purpose SSE package, but instead is a bidirectional protocol for use when Websockets are unavailable. That is, both the client and the server expose a sink and stream on which to send and receive messages respectively.
Both the server and client have implicit assumptions on each other and therefore a client from this package must be paired with a server from this package.
SseHandler validates incoming Origin and Sec-Fetch-Site headers before establishing SSE streams or accepting POST messages:
localhost, 127.0.0.1, ::1) targeting a loopback server are allowed by default.Host-rewriting reverse proxies, separate frontend origins, and browser extensions) must be explicitly permitted via originCheck:final handler = SseHandler( Uri.parse('/sseHandler'), originCheck: (origin) => origin == 'https://app.example.com' || origin.startsWith('chrome-extension://'), );
Origin validation protects against cross-origin browser requests; protecting local loopback servers against DNS rebinding still requires Host-header validation middleware on the embedding HTTP server.