@colibri-social/lexicons 2.12.1 → 2.13.0

package/lexicons/com/atproto/space/notifyWrite.json

@@ -4,12 +4,12 @@
   "defs": {
     "main": {
       "type": "procedure",
-      "description": "Notify that a repo in a space has advanced to a new revision. Sent by a repo host to the space host, and forwarded to registered syncers. Best-effort. Authenticated with service auth.",
+      "description": "Notify that a repo in a space has advanced. Repo hosts reliably deliver their latest state to the space host, which sequences updates and forwards them to registered syncers with reasonable-effort delivery. Authenticated with service auth.",
       "input": {
         "encoding": "application/json",
         "schema": {
           "type": "object",
-          "required": ["space", "repo", "rev", "hash"],
+          "required": ["space", "repo", "repoRev", "hash"],
           "properties": {
             "space": {
               "type": "string",
@@ -21,18 +21,37 @@
               "format": "did",
               "description": "The DID of the account whose repo advanced."
             },
-            "rev": {
+            "repoRev": {
               "type": "string",
-              "description": "The revision of the write.",
+              "description": "The repo revision after the write.",
               "format": "tid"
             },
             "hash": {
               "type": "bytes",
               "description": "The repo's current commit hash (sha256 of the LtHash state) after the write. Lets the space host maintain each repo's hash for listRepos."
+            },
+            "spaceRev": {
+              "type": "string",
+              "format": "tid",
+              "description": "The space revision assigned by the space host. Present only on notifications forwarded to syncers."
+            },
+            "prevSpaceRev": {
+              "type": "string",
+              "format": "tid",
+              "description": "The previous space revision. Omitted on the first update in a space. A gap indicates missed notifications; recover using listRepos with cursor."
             }
           }
         }
-      }
+      },
+      "errors": [
+        {
+          "name": "SpaceNotFound"
+        },
+        {
+          "name": "FutureRev",
+          "description": "The repo revision exceeds the permitted clock skew."
+        }
+      ]
     }
   }
 }

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

@@ -102,11 +102,21 @@
 				"text": {
 					"type": "string",
 					"description": "The status text.",
-					"maxLength": 32
+					"maxLength": 64
 				},
 				"emoji": {
 					"type": "string",
 					"description": "An emoji shown beside the status."
+				},
+				"expiresAt": {
+					"type": "string",
+					"format": "datetime",
+					"description": "When the status clears. The AppView stops returning the status once this time passes. Absent means it never expires."
+				},
+				"showWhileOffline": {
+					"type": "boolean",
+					"description": "Whether a client shows the status while the user is offline.",
+					"default": false
 				}
 			}
 		},

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

@@ -13,12 +13,25 @@
 						"text": {
 							"type": "string",
 							"description": "The status text. Absent leaves the current value unchanged.",
-							"maxLength": 32
+							"maxLength": 64
 						},
 						"emoji": {
 							"type": "string",
 							"description": "An emoji shown beside the status. Absent leaves the current value unchanged."
 						},
+						"expiresAt": {
+							"type": "string",
+							"format": "datetime",
+							"description": "When the status clears. Absent leaves the current value unchanged. Takes precedence over removeExpiresAt."
+						},
+						"removeExpiresAt": {
+							"type": "boolean",
+							"description": "Removes the status expiry, so the status stays until it is changed. Ignored when expiresAt is also given."
+						},
+						"showWhileOffline": {
+							"type": "boolean",
+							"description": "Whether a client shows the status while the user is offline. Absent leaves the current value unchanged."
+						},
 						"onlineState": {
 							"type": "string",
 							"description": "Derived online state. Absent leaves the current value unchanged.",

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

@@ -29,6 +29,10 @@
 						"requiresApprovalToJoin": {
 							"type": "boolean",
 							"description": "Whether joining produces an application a moderator must approve. Defaults to false."
+						},
+						"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. Defaults to false."
 						}
 					}
 				}

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

@@ -56,6 +56,10 @@
 					"type": "boolean",
 					"description": "Whether link previews are shown by default."
 				},
+				"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. Absent means false."
+				},
 				"labelers": {
 					"type": "array",
 					"items": {
@@ -275,6 +279,11 @@
 					"description": "Hex colour as #rrggbb.",
 					"maxLength": 7
 				},
+				"badge": {
+					"type": "union",
+					"refs": ["#roleIconBadge", "#roleImageBadgeView"],
+					"description": "The role's badge, if it has one."
+				},
 				"permissions": {
 					"type": "array",
 					"items": {
@@ -341,6 +350,36 @@
 				}
 			}
 		},
+		"roleIconBadge": {
+			"type": "object",
+			"description": "A role 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 client's 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."
+				}
+			}
+		},
+		"roleImageBadgeView": {
+			"type": "object",
+			"description": "A badge drawn from an uploaded image.",
+			"required": ["image"],
+			"properties": {
+				"image": {
+					"type": "string",
+					"format": "uri",
+					"description": "URL of the badge image, served by this AppView's blob proxy."
+				}
+			}
+		},
 		"memberView": {
 			"type": "object",
 			"description": "An admitted community member.",

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

@@ -29,6 +29,11 @@
 						"default": true,
 						"description": "Whether link previews are shown by default. Channels may override this."
 					},
+					"overrideUserNameColors": {
+						"type": "boolean",
+						"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."
+					},
 					"labelers": {
 						"type": "array",
 						"items": {

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

@@ -43,6 +43,10 @@
 								"description": "A labeler."
 							},
 							"description": "DIDs whose labels this community honours."
+						},
+						"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."
 						}
 					}
 				}

package/lexicons/social/colibri/beta/notification/registerPush.json

@@ -4,7 +4,7 @@
 	"defs": {
 		"main": {
 			"type": "procedure",
-			"description": "Registers a push endpoint for the requesting user's device. Web Push requires endpoint, p256dh, and auth. FCM requires token.",
+			"description": "Registers a push endpoint for the requesting user's device. Web Push requires endpoint, p256dh, and auth. FCM requires token. APNs requires token and environment.",
 			"input": {
 				"encoding": "application/json",
 				"schema": {
@@ -14,12 +14,12 @@
 						"provider": {
 							"type": "string",
 							"description": "The push provider to register with.",
-							"knownValues": ["webpush", "fcm"]
+							"knownValues": ["webpush", "fcm", "apns"]
 						},
 						"platform": {
 							"type": "string",
 							"description": "The platform the device runs.",
-							"knownValues": ["web", "ios", "android"]
+							"knownValues": ["web", "ios", "android", "macos"]
 						},
 						"endpoint": {
 							"type": "string",
@@ -36,7 +36,12 @@
 						},
 						"token": {
 							"type": "string",
-							"description": "The FCM registration token. Required when provider is fcm."
+							"description": "The FCM registration token or the hex-encoded APNs device token. Required when provider is fcm or apns."
+						},
+						"environment": {
+							"type": "string",
+							"description": "The APNs environment the device token belongs to. Required when provider is apns.",
+							"knownValues": ["sandbox", "production"]
 						}
 					}
 				}

package/lexicons/social/colibri/beta/notification/unregisterPush.json

@@ -14,7 +14,7 @@
 						"provider": {
 							"type": "string",
 							"description": "The push provider to unregister from.",
-							"knownValues": ["webpush", "fcm"]
+							"knownValues": ["webpush", "fcm", "apns"]
 						},
 						"endpoint": {
 							"type": "string",
@@ -23,7 +23,7 @@
 						},
 						"token": {
 							"type": "string",
-							"description": "The FCM registration token to remove."
+							"description": "The FCM registration token or APNs device token to remove."
 						}
 					}
 				}

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.1",
+  "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",