niminem/sse

This is a library for the Nim programming language that implements Server-Sent Events, a way for a server to push a continuous stream of small text updates to a client over a single connection. It follows the official web standard closely and uses only Nim's built in tools, with no outside dependencies, talking to sockets directly rather than relying on a separate HTTP library. The library gives you two ways to receive an event stream. An async client works well if your program already runs on Nim's asynchronous dispatch system and you want to handle many streams at once on one thread. A sync client blocks the calling thread instead, which suits simple scripts, command line tools, or programs that give each stream its own dedicated thread. Both clients support the same features: automatic reconnection with increasing wait times between attempts, resuming a stream from where it left off after a disconnect, following redirects, and detecting when a server has gone silent. While the official standard for these events only supports simple GET requests, many modern services, including AI chat APIs, expect a POST request with a JSON body and authentication headers while still streaming the response back as events. This library supports that pattern directly, letting you set a custom HTTP method, extra headers, and a request body. It also warns that automatic reconnection should usually be turned off for these request and response style streams, since reconnecting would resend and effectively rerun the entire original request. For building a server rather than a client, the library provides helper functions that produce correctly formatted event data, automatically assign increasing event IDs, keep a short history of recent events so a reconnecting client does not miss anything, and track when a heartbeat message is needed to keep the connection alive through proxies. These server helpers do not perform any networking themselves. They simply return the properly formatted bytes, so they work with any HTTP server or transport you choose to write them to. The library also includes real TLS hostname verification on every supported platform, including Windows, closing a gap where Nim's standard library normally skips that check.