@colibri-social/lexicons 2.12.0 → 2.13.0

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

@@ -103,6 +103,7 @@
 						"social.colibri.beta.role.create",
 						"social.colibri.beta.role.update",
 						"social.colibri.beta.role.delete",
+						"social.colibri.beta.role.putBadgeImage",
 						"social.colibri.beta.voice.moderate",
 						"social.colibri.beta.thread.delete",
 						"social.colibri.beta.thread.repoint",

package/lexicons/social/colibri/beta/role/create.json

@@ -35,6 +35,11 @@
 							"maxLength": 7,
 							"description": "Hex colour as #rrggbb."
 						},
+						"badge": {
+							"type": "ref",
+							"ref": "social.colibri.beta.community.defs#roleIconBadge",
+							"description": "An icon badge. Image badges are set with social.colibri.beta.role.putBadgeImage."
+						},
 						"position": {
 							"type": "integer",
 							"description": "Hierarchy position. Higher outranks lower."

package/lexicons/social/colibri/beta/role/putBadgeImage.json

@@ -0,0 +1,80 @@
+{
+	"lexicon": 1,
+	"id": "social.colibri.beta.role.putBadgeImage",
+	"defs": {
+		"main": {
+			"type": "procedure",
+			"description": "Sets a role's badge to an uploaded image. The bytes are uploaded to the community's own repo, which is why this goes through the AppView: a space record must reference a blob living in the repo that holds the record. Replaces whatever badge was there before. Use social.colibri.beta.role.update with removeBadge to clear it.",
+			"parameters": {
+				"type": "params",
+				"required": ["community", "role"],
+				"properties": {
+					"community": {
+						"type": "string",
+						"format": "did",
+						"description": "The community the role belongs to."
+					},
+					"role": {
+						"type": "string",
+						"format": "record-key",
+						"description": "The role's record key."
+					}
+				}
+			},
+			"input": {
+				"encoding": "image/*",
+				"description": "The raw image bytes, at most 256 KB. The content type must be one of image/jpeg, image/png, image/gif or image/webp, and is sniffed rather than trusted."
+			},
+			"output": {
+				"encoding": "application/json",
+				"schema": {
+					"type": "object",
+					"required": ["role"],
+					"properties": {
+						"role": {
+							"type": "ref",
+							"ref": "social.colibri.beta.community.defs#roleView",
+							"description": "The role with the new badge resolved."
+						}
+					}
+				}
+			},
+			"errors": [
+				{
+					"name": "AuthRequired",
+					"description": "The request is missing, malformed, or unverifiable service auth."
+				},
+				{
+					"name": "Forbidden",
+					"description": "The caller lacks the role.manage permission."
+				},
+				{ "name": "CommunityNotFound", "description": "No community exists at the given DID." },
+				{ "name": "RoleNotFound", "description": "No role exists at the given record key." },
+				{
+					"name": "RoleProtected",
+					"description": "The role is marked protected and cannot be modified."
+				},
+				{
+					"name": "RoleHierarchy",
+					"description": "The role is at or above the caller's highest role position."
+				},
+				{
+					"name": "UnsupportedImage",
+					"description": "The bytes are not one of the accepted image types."
+				},
+				{
+					"name": "ImageTooLarge",
+					"description": "The image exceeds 256 KB."
+				},
+				{
+					"name": "CredentialsUnavailable",
+					"description": "The AppView cannot act as the community because its stored credentials are missing or unusable."
+				},
+				{
+					"name": "UpstreamFailure",
+					"description": "A PDS or third-party call the AppView depends on failed."
+				}
+			]
+		}
+	}
+}

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

@@ -32,6 +32,15 @@
 							"maxLength": 7,
 							"description": "Hex colour as #rrggbb."
 						},
+						"badge": {
+							"type": "ref",
+							"ref": "social.colibri.beta.community.defs#roleIconBadge",
+							"description": "An icon badge. Image badges are set with social.colibri.beta.role.putBadgeImage. Takes precedence over removeBadge."
+						},
+						"removeBadge": {
+							"type": "boolean",
+							"description": "Removes the role's badge, whichever kind it is. Ignored when badge is also given."
+						},
 						"permissions": {
 							"type": "array",
 							"items": {

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

@@ -21,6 +21,11 @@
 						"maxLength": 7,
 						"description": "Hex colour as #rrggbb."
 					},
+					"badge": {
+						"type": "union",
+						"refs": ["#iconBadge", "#imageBadge"],
+						"description": "A small badge shown next to the names of members holding this role."
+					},
 					"permissions": {
 						"type": "array",
 						"items": {
@@ -84,6 +89,37 @@
 					"description": "Permissions denied within this channel. Deny beats both the base permissions and allow."
 				}
 			}
+		},
+		"iconBadge": {
+			"type": "object",
+			"description": "A badge drawn from the client's curated icon set.",
+			"required": ["icon"],
+			"properties": {
+				"icon": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 64,
+					"description": "The icon's identifier in the curated set, for example shield-check."
+				},
+				"color": {
+					"type": "string",
+					"maxLength": 7,
+					"description": "Hex colour as #rrggbb. Absent means the role colour, or the client's default badge colour when the role has none."
+				}
+			}
+		},
+		"imageBadge": {
+			"type": "object",
+			"description": "A badge drawn from an uploaded image.",
+			"required": ["image"],
+			"properties": {
+				"image": {
+					"type": "blob",
+					"accept": ["image/jpeg", "image/png", "image/gif", "image/webp"],
+					"maxSize": 262144,
+					"description": "A square image, shown at about 16 pixels."
+				}
+			}
 		}
 	}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colibri-social/lexicons",
-  "version": "2.12.0",
+  "version": "2.13.0",
   "description": "Colibri lexicon schemas and the types generated from them",
   "type": "module",
   "exports": {
@@ -27,8 +27,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@atproto/lex": "0.0.0-spaces-alpha-20260915165437",
-    "@atproto/lex-data": "0.0.0-spaces-alpha-20260915165437"
+    "@atproto/lex": "0.0.0-spaces-alpha-20261001173819",
+    "@atproto/lex-data": "0.0.0-spaces-alpha-20261001173819"
   },
   "scripts": {
     "build": "tsc --build",