Add Guest Star settings contract

README.md

@@ -18,3 +18,8 @@ The shared boundary vocabulary includes the ordered permission levels in
 the authenticated `realtime-event.json` envelope; clients must ignore event
 types they do not understand.
 
+Guest Star channel settings are described by
+`contracts/v1/guest-star-channel-settings-response.json`. The browser-source
+token is a server-to-authenticated-client value and fixtures use a synthetic
+placeholder only.
+

contracts/v1/guest-star-channel-settings-response.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://trixie.local/contracts/v1/guest-star-channel-settings-response.json",
+  "title": "Guest Star channel settings response",
+  "type": "object",
+  "required": [
+    "is_moderator_send_live_enabled",
+    "slot_count",
+    "is_browser_source_audio_enabled",
+    "group_layout",
+    "browser_source_token"
+  ],
+  "properties": {
+    "is_moderator_send_live_enabled": { "type": "boolean" },
+    "slot_count": { "type": "integer", "minimum": 1, "maximum": 6 },
+    "is_browser_source_audio_enabled": { "type": "boolean" },
+    "group_layout": {
+      "type": "string",
+      "enum": ["TILED_LAYOUT", "SCREENSHARE_LAYOUT", "HORIZONTAL_LAYOUT", "VERTICAL_LAYOUT"]
+    },
+    "browser_source_token": { "type": "string", "minLength": 1 }
+  },
+  "additionalProperties": false
+}

fixtures/v1/guest-star-channel-settings-response.json

@@ -0,0 +1,7 @@
+{
+  "is_moderator_send_live_enabled": true,
+  "slot_count": 4,
+  "is_browser_source_audio_enabled": false,
+  "group_layout": "TILED_LAYOUT",
+  "browser_source_token": "fixture-token-never-use"
+}