@colibri-social/lexicons 2.14.0 → 2.16.0

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

@@ -208,7 +208,7 @@
 				"notificationLevel": {
 					"type": "string",
 					"description": "Which messages produce a notification.",
-					"knownValues": ["all", "mentionsAndReplies"]
+					"knownValues": ["all", "mentionsAndReplies", "nothing"]
 				},
 				"communityOrder": {
 					"type": "array",
@@ -238,6 +238,24 @@
 				"shareActivity": {
 					"type": "boolean",
 					"description": "Whether the AppView may read what the user is listening to and show it to others."
+				},
+				"spaceNotifications": {
+					"type": "array",
+					"items": {
+						"type": "ref",
+						"ref": "#spaceNotification"
+					},
+					"description": "Notification levels the user set for single communities. A community without an entry follows notificationLevel."
+				},
+				"clientPreferences": {
+					"type": "ref",
+					"ref": "#clientPreferences",
+					"description": "Client settings that follow the user across devices."
+				},
+				"composerState": {
+					"type": "ref",
+					"ref": "#composerState",
+					"description": "Emoji usage, skin tone and recent GIFs."
 				}
 			}
 		},
@@ -294,6 +312,186 @@
 					"description": "The muted thread's space."
 				}
 			}
+		},
+		"spaceNotification": {
+			"type": "object",
+			"description": "A notification level for one community.",
+			"required": ["community", "level"],
+			"properties": {
+				"community": {
+					"type": "string",
+					"format": "did",
+					"description": "The community."
+				},
+				"level": {
+					"type": "string",
+					"knownValues": ["all", "mentionsAndReplies", "nothing"],
+					"description": "Which messages in this community produce a notification."
+				}
+			}
+		},
+		"clientPreferences": {
+			"type": "object",
+			"description": "Client settings that follow the user across devices. Every field is optional and a client applies its own default for an absent one.",
+			"properties": {
+				"controls": {
+					"type": "ref",
+					"ref": "#controls",
+					"description": "Touch gestures in a channel."
+				},
+				"theme": {
+					"type": "string",
+					"knownValues": ["system", "dark", "light"],
+					"description": "The color theme. system follows the operating system."
+				},
+				"messagePreviews": {
+					"type": "boolean",
+					"description": "Whether the channel list shows the latest message under each channel name."
+				},
+				"linkEmbedsByDefault": {
+					"type": "boolean",
+					"description": "Whether a link in a new message gets a preview by default."
+				},
+				"warnOnExternalLinks": {
+					"type": "boolean",
+					"description": "Whether opening a link to another site asks for confirmation first."
+				},
+				"blueskyClient": {
+					"type": "string",
+					"maxLength": 64,
+					"knownValues": [
+						"anisota",
+						"blacksky",
+						"bluesky",
+						"deer",
+						"mu",
+						"northsky",
+						"witchsky",
+						"custom"
+					],
+					"description": "The client that Bluesky posts and profiles open in."
+				},
+				"customBlueskyClientBase": {
+					"type": "string",
+					"maxLength": 253,
+					"description": "The domain of the client used when blueskyClient is custom."
+				},
+				"developerMode": {
+					"type": "boolean",
+					"description": "Whether the client shows identifiers and links to inspect records."
+				},
+				"voiceView": {
+					"type": "ref",
+					"ref": "#voiceView",
+					"description": "Options for voice channels."
+				},
+				"experiments": {
+					"type": "array",
+					"maxLength": 64,
+					"items": {
+						"type": "string",
+						"maxLength": 64,
+						"description": "An experiment id."
+					},
+					"description": "The experiments the user turned on."
+				}
+			}
+		},
+		"controls": {
+			"type": "object",
+			"description": "Touch gestures in a channel.",
+			"properties": {
+				"swipeLeftAction": {
+					"type": "string",
+					"knownValues": ["members", "reply"],
+					"description": "What swiping left on a message does."
+				},
+				"doubleTapEnabled": {
+					"type": "boolean",
+					"description": "Whether double tapping a message does anything."
+				},
+				"doubleTapAction": {
+					"type": "string",
+					"knownValues": ["react", "editOrReply"],
+					"description": "What double tapping a message does."
+				},
+				"doubleTapReactionEmoji": {
+					"type": "string",
+					"maxLength": 64,
+					"maxGraphemes": 1,
+					"description": "The emoji a double tap reacts with."
+				}
+			}
+		},
+		"voiceView": {
+			"type": "object",
+			"description": "Options for voice channels.",
+			"properties": {
+				"confirmJoin": {
+					"type": "boolean",
+					"description": "Whether opening a voice channel waits for the user to press join."
+				},
+				"showNonVideoParticipants": {
+					"type": "boolean",
+					"description": "Whether the call grid shows participants without video."
+				},
+				"showOwnCamera": {
+					"type": "boolean",
+					"description": "Whether the call grid shows the user's own camera."
+				}
+			}
+		},
+		"composerState": {
+			"type": "object",
+			"description": "Emoji usage, skin tone and recent GIFs.",
+			"properties": {
+				"emojiUsage": {
+					"type": "array",
+					"maxLength": 50,
+					"items": {
+						"type": "ref",
+						"ref": "#emojiUse"
+					},
+					"description": "The emoji the user picks most, with counts."
+				},
+				"skinTone": {
+					"type": "integer",
+					"minimum": 0,
+					"maximum": 5,
+					"description": "The skin tone for emoji that support one. 0 is the default yellow."
+				},
+				"recentGifs": {
+					"type": "array",
+					"maxLength": 24,
+					"items": {
+						"type": "ref",
+						"ref": "social.colibri.beta.embed.defs#gifView"
+					},
+					"description": "The GIFs the user sent last, newest first, stored whole."
+				}
+			}
+		},
+		"emojiUse": {
+			"type": "object",
+			"description": "How often and how recently the user picked one emoji.",
+			"required": ["emoji", "count", "lastUsed"],
+			"properties": {
+				"emoji": {
+					"type": "string",
+					"maxLength": 512,
+					"description": "A Unicode emoji, or a custom emoji's AT URI."
+				},
+				"count": {
+					"type": "integer",
+					"minimum": 1,
+					"description": "How many times the user picked it."
+				},
+				"lastUsed": {
+					"type": "string",
+					"format": "datetime",
+					"description": "When the user last picked it."
+				}
+			}
 		}
 	}
 }

package/lexicons/social/colibri/beta/actor/mute.json

@@ -14,10 +14,11 @@
 						"type": "union",
 						"refs": [
 							"social.colibri.beta.actor.defs#mutedActor",
-							"social.colibri.beta.actor.defs#mutedChannel"
+							"social.colibri.beta.actor.defs#mutedChannel",
+							"social.colibri.beta.actor.defs#mutedThread"
 						],
 						"closed": true,
-						"description": "What is muted. A user or a community is named by DID, a channel by its space."
+						"description": "What is muted. A user or a community is named by DID, a channel or a thread by its space."
 					},
 					"createdAt": {
 						"type": "string",

package/lexicons/social/colibri/beta/actor/putSettings.json

@@ -13,7 +13,7 @@
 						"notificationLevel": {
 							"type": "string",
 							"description": "Which messages produce a notification. Absent leaves the current value unchanged.",
-							"knownValues": ["all", "mentionsAndReplies"]
+							"knownValues": ["all", "mentionsAndReplies", "nothing"]
 						},
 						"communityOrder": {
 							"type": "array",
@@ -35,6 +35,16 @@
 						"shareActivity": {
 							"type": "boolean",
 							"description": "Whether the AppView may show what the user is listening to. Absent leaves the current value unchanged."
+						},
+						"clientPreferences": {
+							"type": "ref",
+							"ref": "social.colibri.beta.actor.defs#clientPreferences",
+							"description": "The contents of the user's social.colibri.beta.actor.clientPreferences record. Replaces the stored copy whole. Absent leaves the current value unchanged."
+						},
+						"composerState": {
+							"type": "ref",
+							"ref": "social.colibri.beta.actor.defs#composerState",
+							"description": "The contents of the user's social.colibri.beta.actor.composerState record. Replaces the stored copy whole. Absent leaves the current value unchanged."
 						}
 					}
 				}

package/lexicons/social/colibri/beta/actor/putSpaceNotification.json

@@ -0,0 +1,57 @@
+{
+	"lexicon": 1,
+	"id": "social.colibri.beta.actor.putSpaceNotification",
+	"defs": {
+		"main": {
+			"type": "procedure",
+			"description": "Pushes one of the requesting user's social.colibri.beta.actor.spaceNotification records to the AppView, so it takes effect immediately instead of waiting for a sync notification. The client writes or deletes the record in its own personal space first, then calls this.",
+			"input": {
+				"encoding": "application/json",
+				"schema": {
+					"type": "object",
+					"required": ["community"],
+					"properties": {
+						"community": {
+							"type": "string",
+							"format": "did",
+							"description": "The community."
+						},
+						"level": {
+							"type": "string",
+							"knownValues": ["all", "mentionsAndReplies", "nothing"],
+							"description": "The new level. Absent together with removeLevel returns the community to the global level."
+						},
+						"removeLevel": {
+							"type": "boolean",
+							"description": "Removes the community's level so it follows the global one. Ignored when level is present."
+						}
+					}
+				}
+			},
+			"output": {
+				"encoding": "application/json",
+				"schema": {
+					"type": "object",
+					"required": ["preferences"],
+					"properties": {
+						"preferences": {
+							"type": "ref",
+							"ref": "social.colibri.beta.actor.defs#preferences",
+							"description": "The requesting user's settings, after the update."
+						}
+					}
+				}
+			},
+			"errors": [
+				{
+					"name": "AuthRequired",
+					"description": "The request has no valid service auth."
+				},
+				{
+					"name": "InvalidRequest",
+					"description": "Neither level nor removeLevel is present, or level does not hold an allowed value."
+				}
+			]
+		}
+	}
+}

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

@@ -12,7 +12,7 @@
 				"properties": {
 					"notificationLevel": {
 						"type": "string",
-						"knownValues": ["all", "mentionsAndReplies"],
+						"knownValues": ["all", "mentionsAndReplies", "nothing"],
 						"default": "all",
 						"description": "Which messages produce a notification."
 					},

package/lexicons/social/colibri/beta/actor/spaceNotification.json

@@ -0,0 +1,27 @@
+{
+	"lexicon": 1,
+	"id": "social.colibri.beta.actor.spaceNotification",
+	"defs": {
+		"main": {
+			"type": "record",
+			"description": "A notification level for one community, overriding the level in social.colibri.beta.actor.settings. The record key is the community's DID. Deleting the record returns the community to the global level.",
+			"key": "any",
+			"record": {
+				"type": "object",
+				"required": ["level", "createdAt"],
+				"properties": {
+					"level": {
+						"type": "string",
+						"knownValues": ["all", "mentionsAndReplies", "nothing"],
+						"description": "Which messages in this community produce a notification."
+					},
+					"createdAt": {
+						"type": "string",
+						"format": "datetime",
+						"description": "When the level was set."
+					}
+				}
+			}
+		}
+	}
+}

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

@@ -216,6 +216,10 @@
 				"height": {
 					"type": "integer",
 					"description": "Intrinsic pixel height, when the file is a decodable image or video."
+				},
+				"spoiler": {
+					"type": "boolean",
+					"description": "Whether the author marked the file as a spoiler. Clients hide it behind a reveal step."
 				}
 			}
 		},

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

@@ -58,6 +58,10 @@
 							"type": "boolean",
 							"description": "Whether link previews are shown here. Absent leaves the current value unchanged."
 						},
+						"removeLinkEmbeds": {
+							"type": "boolean",
+							"description": "Clears the channel's link preview setting so the community default applies. Ignored when linkEmbeds is also given."
+						},
 						"visibleToRoles": {
 							"type": "array",
 							"description": "Roles that may read this channel. Empty means every member may.",

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/package.json

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