@colibri-social/lexicons 2.13.0 → 2.15.0

package/lexicons/social/colibri/beta/channel/putReadCursors.json

@@ -4,7 +4,7 @@
 	"defs": {
 		"main": {
 			"type": "procedure",
-			"description": "Pushes the requesting user's read cursors for one community to the AppView, so unread counts update immediately instead of waiting for a sync notification. The client writes its social.colibri.beta.channel.read record for the community to its own personal space first, then calls this. Clients should debounce this rather than calling it on every message.",
+			"description": "Pushes the requesting user's read cursors for one community to the AppView, so unread counts update immediately instead of waiting for a sync notification. The client writes its social.colibri.beta.channel.read record for the community to its own personal space first, then calls this. Clients should debounce this rather than calling it on every message. The user's other sessions receive the cursors that moved as a social.colibri.beta.sync.defs#readCursorEvent.",
 			"input": {
 				"encoding": "application/json",
 				"schema": {
@@ -18,7 +18,7 @@
 						},
 						"cursors": {
 							"type": "array",
-							"description": "The complete, replacement set of read cursors for the community's channels.",
+							"description": "Read cursors for the community's channels and threads. Each one replaces the stored cursor only when it is newer, and channels left out keep their stored cursor.",
 							"items": {
 								"type": "ref",
 								"ref": "social.colibri.beta.channel.read#cursor"

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

@@ -60,6 +60,11 @@
 					"type": "boolean",
 					"description": "Whether only role colours are shown in chat. Members' own name colours are hidden, and a member without a coloured role shows the default name colour. Absent means false."
 				},
+				"customEmoji": {
+					"type": "string",
+					"knownValues": ["all", "local", "none"],
+					"description": "Which custom emoji render in this community. all allows custom emoji from any source, local only the community's own emoji, none disables custom emoji. Disallowed emoji show their fallback text. Absent means all."
+				},
 				"labelers": {
 					"type": "array",
 					"items": {
@@ -146,6 +151,50 @@
 						"ref": "#channelView"
 					},
 					"description": "Channels in display order."
+				},
+				"ownerOnly": {
+					"type": "boolean",
+					"description": "Whether only community admins may post in the category's channels. A channel that sets its own posting restriction overrides this."
+				},
+				"allowedRoles": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"format": "record-key",
+						"description": "A role permitted to post."
+					},
+					"description": "Roles allowed to post in the category's channels. Empty means no role restriction. A channel that sets its own posting restriction overrides this."
+				},
+				"allowedMembers": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"format": "did",
+						"description": "A member permitted to post."
+					},
+					"description": "Members allowed to post in the category's channels in addition to allowedRoles."
+				},
+				"visibleToRoles": {
+					"type": "array",
+					"description": "Roles that may read the category's channels. Empty or absent means every member may read them. A channel with its own non-empty visibleToRoles or visibleToMembers overrides this. A non-empty list makes the category's other channels private, enforced the same way as a private channel.",
+					"items": {
+						"type": "string",
+						"format": "record-key",
+						"description": "A role permitted to read."
+					}
+				},
+				"visibleToMembers": {
+					"type": "array",
+					"description": "Members that may read the category's channels in addition to visibleToRoles.",
+					"items": {
+						"type": "string",
+						"format": "did",
+						"description": "A member permitted to read."
+					}
+				},
+				"private": {
+					"type": "boolean",
+					"description": "Whether the category restricts who may read its channels."
 				}
 			}
 		},

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

@@ -34,6 +34,12 @@
 						"default": false,
 						"description": "Whether only role colours are shown in chat. Members' own name colours are hidden, and a member without a coloured role shows the default name colour. Defaults to false."
 					},
+					"customEmoji": {
+						"type": "string",
+						"knownValues": ["all", "local", "none"],
+						"default": "all",
+						"description": "Which custom emoji render in this community. all allows custom emoji from any source, local only the community's own emoji, none disables custom emoji. Disallowed emoji show their fallback text. Defaults to all."
+					},
 					"labelers": {
 						"type": "array",
 						"items": {

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

@@ -0,0 +1,78 @@
+{
+	"lexicon": 1,
+	"id": "social.colibri.beta.community.transferOwnership",
+	"defs": {
+		"main": {
+			"type": "procedure",
+			"description": "Hands the community's protected owner role from the caller to another member. The subject gains every protected role the caller holds, then the caller loses them. The caller keeps their other roles.",
+			"input": {
+				"encoding": "application/json",
+				"schema": {
+					"type": "object",
+					"required": ["community", "subject"],
+					"properties": {
+						"community": {
+							"type": "string",
+							"format": "did",
+							"description": "The community whose ownership is transferred."
+						},
+						"subject": {
+							"type": "string",
+							"format": "did",
+							"description": "The member who becomes the owner."
+						}
+					}
+				}
+			},
+			"output": {
+				"encoding": "application/json",
+				"schema": {
+					"type": "object",
+					"required": ["owner", "previousOwner"],
+					"properties": {
+						"owner": {
+							"type": "ref",
+							"ref": "social.colibri.beta.community.defs#memberView",
+							"description": "The new owner, with their updated roles."
+						},
+						"previousOwner": {
+							"type": "ref",
+							"ref": "social.colibri.beta.community.defs#memberView",
+							"description": "The caller, with their updated roles."
+						}
+					}
+				}
+			},
+			"errors": [
+				{
+					"name": "AuthRequired",
+					"description": "The request is missing, malformed, or unverifiable service auth."
+				},
+				{
+					"name": "Forbidden",
+					"description": "The caller does not hold a protected owner role in this community."
+				},
+				{
+					"name": "CommunityNotFound",
+					"description": "No community exists with that DID."
+				},
+				{
+					"name": "MemberNotFound",
+					"description": "The subject does not hold a member record in this community."
+				},
+				{
+					"name": "Banned",
+					"description": "The subject is banned from this community."
+				},
+				{
+					"name": "AlreadyOwner",
+					"description": "The subject already holds a protected owner role."
+				},
+				{
+					"name": "CredentialsUnavailable",
+					"description": "The AppView's stored credentials for this community are missing or unusable."
+				}
+			]
+		}
+	}
+}

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

@@ -47,6 +47,11 @@
 						"overrideUserNameColors": {
 							"type": "boolean",
 							"description": "Whether only role colours are shown in chat. Members' own name colours are hidden, and a member without a coloured role shows the default name colour."
+						},
+						"customEmoji": {
+							"type": "string",
+							"knownValues": ["all", "local", "none"],
+							"description": "Which custom emoji render in this community. all allows custom emoji from any source, local only the community's own emoji, none disables custom emoji. Disallowed emoji show their fallback text."
 						}
 					}
 				}

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

@@ -120,6 +120,10 @@
 					"type": "string",
 					"maxLength": 256,
 					"description": "The original filename."
+				},
+				"spoiler": {
+					"type": "boolean",
+					"description": "Whether clients hide the file behind a reveal step until the reader chooses to see it."
 				}
 			}
 		}

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

@@ -5,7 +5,7 @@
 		"main": {
 			"type": "permission-set",
 			"title": "Your Colibri account",
-			"detail": "Read and change your Colibri profile, settings, mutes and read state.",
+			"detail": "Read and change your Colibri profile, settings, mutes, notification levels and read state.",
 			"permissions": [
 				{
 					"type": "permission",
@@ -14,8 +14,11 @@
 					"authority": "self",
 					"skey": "self",
 					"collection": [
+						"social.colibri.beta.actor.clientPreferences",
+						"social.colibri.beta.actor.composerState",
 						"social.colibri.beta.actor.mute",
 						"social.colibri.beta.actor.settings",
+						"social.colibri.beta.actor.spaceNotification",
 						"social.colibri.beta.channel.read"
 					],
 					"action": ["read", "create", "update", "delete"],
@@ -36,6 +39,7 @@
 						"social.colibri.beta.actor.getPreferences",
 						"social.colibri.beta.actor.putSettings",
 						"social.colibri.beta.actor.putMutes",
+						"social.colibri.beta.actor.putSpaceNotification",
 						"social.colibri.beta.actor.grantSpaceAccess",
 						"social.colibri.beta.actor.listCommunities",
 						"social.colibri.beta.actor.setStatus",

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

@@ -78,6 +78,7 @@
 						"social.colibri.beta.community.migrate",
 						"social.colibri.beta.community.registerCredentials",
 						"social.colibri.beta.community.setMemberRoles",
+						"social.colibri.beta.community.transferOwnership",
 						"social.colibri.beta.community.reorderCategories",
 						"social.colibri.beta.community.createInvitation",
 						"social.colibri.beta.community.listInvitations",

package/lexicons/social/colibri/beta/richtext/facet.json

@@ -33,7 +33,8 @@
 							"#role",
 							"#channel",
 							"#link",
-							"#time"
+							"#time",
+							"#customEmoji"
 						]
 					},
 					"description": "What the range means. A range may carry more than one feature."
@@ -232,6 +233,23 @@
 					"description": "How to render it."
 				}
 			}
+		},
+		"customEmoji": {
+			"type": "object",
+			"description": "A custom emoji. The text under the facet is the emoji's fallback: a Unicode alternative when the emoji has one, otherwise its :name: shortcode.",
+			"required": ["uri"],
+			"properties": {
+				"uri": {
+					"type": "string",
+					"format": "at-uri",
+					"description": "The emoji record. Its collection identifies the emoji lexicon, for example blue.moji.collection.item."
+				},
+				"cid": {
+					"type": "string",
+					"format": "cid",
+					"description": "The version of the emoji record the message was written against."
+				}
+			}
 		}
 	}
 }

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

@@ -518,6 +518,11 @@
 					"format": "space-ref",
 					"description": "The channel that was marked seen, when it was a single channel."
 				},
+				"message": {
+					"type": "ref",
+					"ref": "social.colibri.beta.defs#recordRef",
+					"description": "The message whose notifications were marked seen, when it was a single message."
+				},
 				"seenAt": {
 					"type": "string",
 					"format": "datetime",
@@ -525,6 +530,26 @@
 				}
 			}
 		},
+		"readCursorEvent": {
+			"type": "object",
+			"description": "The connected user's read cursors for one community moved, possibly from another of their sessions. Each cursor is the newest the AppView holds for that channel or thread, so applying the event never moves a cursor backwards.",
+			"required": ["community", "cursors"],
+			"properties": {
+				"community": {
+					"type": "string",
+					"format": "did",
+					"description": "The community the cursors belong to."
+				},
+				"cursors": {
+					"type": "array",
+					"description": "The cursors that changed.",
+					"items": {
+						"type": "ref",
+						"ref": "social.colibri.beta.channel.read#cursor"
+					}
+				}
+			}
+		},
 		"presenceEvent": {
 			"type": "object",
 			"description": "Someone's presence changed.",

package/package.json

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