Skip to content

Commit a18c628

Browse files
authored
Merge pull request #552 from koic/document_listen_delivery_semantics
[Doc] State the Listen Stream Delivery Semantics
2 parents 8e0ae73 + ef3eb7b commit a18c628

1 file changed

Lines changed: 7 additions & 0 deletions

File tree

‎docs/_server/subscriptions.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,13 @@ The first SSE event on the stream is the acknowledgement:
4949
}
5050
```
5151

52+
## Delivery Semantics
53+
54+
A stream delivers only the changes that happen after its acknowledgement; it is not a replay log.
55+
Nothing is queued while no stream is connected, and a dropped stream is gone together with anything it missed.
56+
Clients fetch the current state after subscribing and treat each notification as a cue to refetch,
57+
rather than as a payload.
58+
5259
## Transport Support
5360

5461
The stream is served on the Streamable HTTP modern path; stdio answers `-32601`.

0 commit comments

Comments
 (0)