- The SSE helpers are transport-focused and independent of event store persistence models, routing logic, or authorization policies.
- Event identifiers are preserved verbatim (no trimming) to support opaque schemes where whitespace may be meaningful.
- Validation occurs at construction time; once an
EventIdis created, it is guaranteed wire-safe. - This crate still does not provide a convenience Actix responder or stream lifecycle abstraction for SSE endpoints.
- The
Last-Event-IDheader extraction follows the same single-header-or-error pattern used by theextract_idempotency_keyfunction in the idempotency module. - The heartbeat helper surface is intentionally wire-only: this crate exposes interval data and rendered frames, not timer orchestration.
For implementation guidance and internal conventions, see
developers-guide.md.