Filip/matrix-spec
1
0
Fork 0
mirror of https://github.com/matrix-org/matrix-spec synced 2026-03-28 14:04:10 +01:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Clarify server vs. client behavior.

Browse source
This commit is contained in:
Patrick Cloke 2023-03-07 13:15:04 -05:00
parent 653ce58bb8
commit 6253bd0a4d
1 changed files with 16 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

16
content/client-server-api/modules/push.md
View file

@ -833,6 +833,13 @@ Servers MUST include the number of unread notifications in a client's
`/sync` stream, and MUST update it as it changes. Notifications are `/sync` stream, and MUST update it as it changes. Notifications are
determined by the push rules which apply to an event. determined by the push rules which apply to an event.
For encrypted events, the homeserver has limited access to the event content
and properly processing push rules falls on the client. Clients should process
push rules for each incoming event *after decrypting* them. This may result in
needing to modify the number of unread notifications received from the homeserver.
##### Marking notifications as read
When the user updates their read receipt (either by using the API or by When the user updates their read receipt (either by using the API or by
sending an event), notifications prior to and including that event MUST sending an event), notifications prior to and including that event MUST
be marked as read. Which specific events are affected can vary depending be marked as read. Which specific events are affected can vary depending
@ -864,6 +871,15 @@ to ensure that future events, like `m.reaction`, are correctly considered
#### Server behaviour #### Server behaviour
When receiving a new event homeservers process push rules for all other local
users in the room, this may result in:
* Generating a new number of unread notifications for the user;
* Making a request to the configured push gateway.
The updated notification count from a new event MUST appear in the same `/sync`
response as the event itself.
#### Push Gateway behaviour #### Push Gateway behaviour
##### Recommendations for APNS ##### Recommendations for APNS