feat(quartz): role-check helpers on ParticipantTag

Adds typed role accessors to make participant-list filtering self-documenting: ParticipantTag.effectiveRole(): ROLE? — case-insensitive parse; null when the role string doesn't match any enum value (so an unknown future "director" role doesn't accidentally pass canSpeak). ParticipantTag.isHost() / isModerator() / isSpeaker() — single-role predicates for per-row UI gating. ParticipantTag.canSpeak() — true for HOST / MODERATOR / SPEAKER; the audio-room VM uses this to gate startBroadcast() so anyone who was promoted (not just the original host) can publish. 5 unit tests cover happy paths, case-insensitivity, the unknown-role → null contract, the canSpeak union, and the effectiveRole enum parse. Tier 1 #5 + #6 consume these — promote/demote and kick both need to render different rows depending on whether the local user is a host or moderator (allowed to manage roles) and the target participant's current role.
2026-04-26 22:38:39 +00:00
parent e9aefed496
commit 9fa6f756ca
2 changed files with 93 additions and 0 deletions
@@ -0,0 +1,73 @@
+/*
+ * Copyright (c) 2025 Vitor Pamplona
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of
+ * this software and associated documentation files (the "Software"), to deal in
+ * the Software without restriction, including without limitation the rights to use,
+ * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
+ * Software, and to permit persons to whom the Software is furnished to do so,
+ * subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+ * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+ * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
+ * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+ * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+package com.vitorpamplona.quartz.nip53LiveActivities.streaming.tags
+
+import kotlin.test.Test
+import kotlin.test.assertEquals
+import kotlin.test.assertFalse
+import kotlin.test.assertNull
+import kotlin.test.assertTrue
+
+class ParticipantTagTest {
+    private val pk = "a".repeat(64)
+
+    private fun tag(role: String?) = ParticipantTag(pubKey = pk, relayHint = null, role = role, proof = null)
+
+    @Test
+    fun roleHelpersHostModeratorSpeakerParticipant() {
+        assertTrue(tag("host").isHost())
+        assertFalse(tag("host").isModerator())
+        assertFalse(tag("host").isSpeaker())
+
+        assertTrue(tag("moderator").isModerator())
+        assertTrue(tag("speaker").isSpeaker())
+    }
+
+    @Test
+    fun roleHelpersAreCaseInsensitive() {
+        assertTrue(tag("HOST").isHost())
+        assertTrue(tag("Speaker").isSpeaker())
+    }
+
+    @Test
+    fun unknownRoleHasNoEffectiveRole() {
+        assertNull(tag("director").effectiveRole())
+        assertNull(tag(null).effectiveRole())
+        assertFalse(tag("director").canSpeak())
+    }
+
+    @Test
+    fun canSpeakIncludesHostModeratorAndSpeakerOnly() {
+        assertTrue(tag("host").canSpeak())
+        assertTrue(tag("moderator").canSpeak())
+        assertTrue(tag("speaker").canSpeak())
+        assertFalse(tag("participant").canSpeak())
+        assertFalse(tag(null).canSpeak())
+    }
+
+    @Test
+    fun effectiveRoleParsesEnumValue() {
+        assertEquals(ROLE.HOST, tag("host").effectiveRole())
+        assertEquals(ROLE.MODERATOR, tag("moderator").effectiveRole())
+        assertEquals(ROLE.SPEAKER, tag("speaker").effectiveRole())
+        assertEquals(ROLE.PARTICIPANT, tag("participant").effectiveRole())
+    }
+}