@colibri-social/lexicons 2.1.0 → 2.3.0

package/lexicons/social/colibri/beta/community/listMigratable.json

@@ -0,0 +1,58 @@
+{
+	"lexicon": 1,
+	"id": "social.colibri.beta.community.listMigratable",
+	"defs": {
+		"main": {
+			"type": "query",
+			"description": "Lists the repo-backed communities the requesting user belongs to that have not been migrated onto spaces yet, so a client can offer them as a choice rather than asking for a handle. The AppView reads this live from the user's own public repo and each candidate's public repo, because nothing about an unmigrated community is indexed. Only a community that holds its own DID is listed: an older community that lived in its owner's repo cannot be migrated.",
+			"parameters": {
+				"type": "params",
+				"required": [],
+				"properties": {
+					"includeUnadministered": {
+						"type": "boolean",
+						"default": false,
+						"description": "Whether to include communities the user belongs to but cannot migrate. They come back with viewerIsAdmin false."
+					}
+				}
+			},
+			"output": {
+				"encoding": "application/json",
+				"schema": {
+					"type": "object",
+					"required": ["communities"],
+					"properties": {
+						"communities": {
+							"type": "array",
+							"items": {
+								"type": "ref",
+								"ref": "social.colibri.beta.community.defs#legacyCommunityView",
+								"description": "An unmigrated legacy community."
+							},
+							"description": "Unmigrated legacy communities, in the user's preferred sidebar order where the legacy repo recorded one. This is not paginated: a user's community list is small and every entry costs a live read."
+						},
+						"unreadable": {
+							"type": "array",
+							"items": {
+								"type": "string",
+								"format": "did",
+								"description": "A community DID whose repo could not be read."
+							},
+							"description": "Communities named by the user's repo whose own repo could not be read, so the client can say so instead of silently dropping them."
+						}
+					}
+				}
+			},
+			"errors": [
+				{
+					"name": "AuthRequired",
+					"description": "The request is missing, malformed, or unverifiable service auth."
+				},
+				{
+					"name": "UpstreamFailure",
+					"description": "The requesting user's own PDS could not be read, so no candidate list could be built at all."
+				}
+			]
+		}
+	}
+}

package/lexicons/social/colibri/beta/community/migrate.json

@@ -9,12 +9,12 @@
 				"encoding": "application/json",
 				"schema": {
 					"type": "object",
-					"required": ["legacy"],
+					"required": ["community"],
 					"properties": {
-						"legacy": {
+						"community": {
 							"type": "string",
-							"format": "at-uri",
-							"description": "The legacy social.colibri.beta.community record to migrate."
+							"format": "at-identifier",
+							"description": "The legacy community to migrate, by handle or DID. Only a community that holds its own DID can be migrated, so the DID is the whole address: the record to read is always social.colibri.community at self in that repo."
 						}
 					}
 				}

package/lexicons/social/colibri/beta/permissionCommunity.json

@@ -66,6 +66,7 @@
 						"social.colibri.beta.community.putImage",
 						"social.colibri.beta.community.deleteImage",
 						"social.colibri.beta.community.delete",
+						"social.colibri.beta.community.listMigratable",
 						"social.colibri.beta.community.migrate",
 						"social.colibri.beta.community.registerCredentials",
 						"social.colibri.beta.community.setMemberRoles",

package/lexicons/social/colibri/beta/sync/defs.json

@@ -479,6 +479,18 @@
 				}
 			}
 		},
+		"preferencesEvent": {
+			"type": "object",
+			"description": "The connected user changed their own preferences somewhere else.",
+			"required": ["preferences"],
+			"properties": {
+				"preferences": {
+					"type": "ref",
+					"ref": "social.colibri.beta.actor.defs#preferences",
+					"description": "Their preferences as they now stand."
+				}
+			}
+		},
 		"typingEvent": {
 			"type": "object",
 			"description": "Someone is typing in a subscribed channel.",

package/lexicons/social/colibri/beta/voice/defs.json

@@ -26,8 +26,12 @@
 					"description": "The opaque mediasoup ICE parameters blob."
 				},
 				"iceCandidates": {
-					"type": "unknown",
-					"description": "The opaque mediasoup ICE candidates blob."
+					"type": "array",
+					"description": "The mediasoup ICE candidates, one opaque blob per candidate. This is an array, not a single object, because that is what a WebRTC transport hands back.",
+					"items": {
+						"type": "unknown",
+						"description": "One opaque mediasoup ICE candidate."
+					}
 				},
 				"dtlsParameters": {
 					"type": "unknown",
@@ -333,9 +337,21 @@
 				}
 			}
 		},
+		"disconnected": {
+			"type": "object",
+			"description": "The server removed this client from the voice channel. Sent only to the client it applies to.",
+			"required": [],
+			"properties": {
+				"reason": {
+					"type": "string",
+					"description": "Why it happened.",
+					"knownValues": ["moderator", "superseded", "channelGone"]
+				}
+			}
+		},
 		"moderationChanged": {
 			"type": "object",
-			"description": "A peer's server-enforced mute or deafen state changed.",
+			"description": "A peer's mute or deafen state changed, whether they did it themselves or a moderator did it to them.",
 			"required": ["did", "muted", "deafened"],
 			"properties": {
 				"did": {
@@ -345,11 +361,19 @@
 				},
 				"muted": {
 					"type": "boolean",
-					"description": "Whether the microphone is server-muted."
+					"description": "Whether the microphone is muted, for any reason."
 				},
 				"deafened": {
 					"type": "boolean",
-					"description": "Whether incoming audio is server-silenced."
+					"description": "Whether incoming audio is silenced, for any reason."
+				},
+				"serverMuted": {
+					"type": "boolean",
+					"description": "Whether a moderator muted them. When this is true the peer cannot unmute themselves."
+				},
+				"serverDeafened": {
+					"type": "boolean",
+					"description": "Whether a moderator deafened them. When this is true the peer cannot undeafen themselves."
 				}
 			}
 		}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colibri-social/lexicons",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "Colibri lexicon schemas and the types generated from them",
   "type": "module",
   "exports": {