wholetrans/docs-matrix-spec
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Remove distinction between StateFilter and RoomEventFilter (#2015)

Browse source 
They are exactly the same type, so let's combine their tables together.
This commit is contained in:
Richard van der Hoff 2024-11-27 16:11:39 +00:00 • committed by GitHub
parent c5eac010be
commit f8119f5336
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
4 changed files with 8 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

1
changelogs/client_server/newsfragments/2015.clarification Normal file
View file

@ -0,0 +1 @@
Remove distinction between `StateFilter` and `RoomEventFilter`.

5
content/client-server-api/_index.md
View file

@ -1756,8 +1756,9 @@ events to the client to ease implementation, although such redundancy
should be minimised where possible to conserve bandwidth. should be minimised where possible to conserve bandwidth.
In terms of filters, lazy-loading is enabled by enabling In terms of filters, lazy-loading is enabled by enabling
`lazy_load_members` on a `RoomEventFilter` (or a `StateFilter` in the `lazy_load_members` on a
case of `/sync` only). When enabled, lazy-loading aware endpoints (see [`RoomEventFilter`](#post_matrixclientv3useruseridfilter_request_roomeventfilter).
When enabled, lazy-loading aware endpoints (see
below) will only include membership events for the `sender` of events below) will only include membership events for the `sender` of events
being included in the response. For example, if a client makes a `/sync` being included in the response. For example, if a client makes a `/sync`
request with lazy-loading enabled, the server will only return request with lazy-loading enabled, the server will only return

1
data/api/client-server/definitions/sync_filter.yaml
View file

@ -69,7 +69,6 @@ properties:
type: boolean type: boolean
state: state:
type: object type: object
title: StateFilter
allOf: allOf:
- $ref: room_event_filter.yaml - $ref: room_event_filter.yaml
description: The state events to include for rooms. description: The state events to include for rooms.

3
data/api/client-server/sync.yaml
View file

@ -26,7 +26,8 @@ paths:
incremental deltas to the state, and to receive new messages. incremental deltas to the state, and to receive new messages.
*Note*: This endpoint supports lazy-loading. See [Filtering](/client-server-api/#filtering) *Note*: This endpoint supports lazy-loading. See [Filtering](/client-server-api/#filtering)
for more information. Lazy-loading members is only supported on a `StateFilter` for more information. Lazy-loading members is only supported on the `state` part of a
[`RoomFilter`](#post_matrixclientv3useruseridfilter_request_roomfilter)
for this endpoint. When lazy-loading is enabled, servers MUST include the for this endpoint. When lazy-loading is enabled, servers MUST include the
syncing user's own membership event when they join a room, or when the syncing user's own membership event when they join a room, or when the
full state of rooms is requested, to aid discovering the user's avatar & full state of rooms is requested, to aid discovering the user's avatar &