social.colibri.sync.subscribeHums
Schema Diff
+13 -0
Compatibility Analysis
Backward Compatible
Backward compatible. 2 non-breaking changes.
Non-Breaking Changes (2)
- AddedVertex AddedVertex { vertex_id: "social.colibri.sync.subscribeHums:params" }
- AddedEdge AddedEdge { src: "social.colibri.sync.subscribeHums", tgt: "social.colibri.sync.subscribeHums:params", kind: "prop", name: Some("parameters") }
Migration Guidance
Added Elements
AddedVertex { vertex_id: "social.colibri.sync.subscribeHums:params" }
Additional Notes
- Non-breaking: AddedEdge { src: "social.colibri.sync.subscribeHums", tgt: "social.colibri.sync.subscribeHums:params", kind: "prop", name: Some("parameters") }
1
1
{
2
2
"id": "social.colibri.sync.subscribeHums",
3
3
"defs": {
4
4
"main": {
5
5
"type": "subscription",
6
6
"errors": [
7
7
{
8
8
"name": "AuthRequired"
9
9
},
10
10
{
11
11
"name": "NotEnabled",
12
12
"description": "Humming is disabled on this AppView."
13
13
},
14
14
{
15
15
"name": "TooManySubscribers",
16
16
"description": "The hub is at its subscribeHums connection limit."
17
17
}
18
18
],
19
19
"message": {
20
20
"schema": {
21
21
"refs": [
22
22
"lex:social.colibri.sync.subscribeEvents#humEnvelope"
23
23
],
24
24
"type": "union"
25
25
}
26
26
},
27
+
"parameters": {
28
+
"type": "params",
29
+
"properties": {
30
+
"communities": {
31
+
"type": "array",
32
+
"items": {
33
+
"type": "string",
34
+
"format": "did"
35
+
},
36
+
"description": "DIDs of the communities the peer wants Hums for, repeated once per community. Narrowing only: the intersection with what the peer is authorised for is what gets streamed, so declaring a community grants nothing. Omit it entirely to receive every authorised community."
37
+
}
38
+
}
39
+
},
27
40
"description": "Egress-only WebSocket stream of Hums this AppView is relaying. Peers subscribe to receive off-protocol events for shared communities, optionally narrowing to declared `communities` (repeated query param). Requires inter-service auth (subprotocol-carried, as with subscribeEvents). Clients cannot send messages on this stream."
28
41
}
29
42
},
30
43
"$type": "com.atproto.lexicon.schema",
31
44
"lexicon": 1
32
45
}