feat(nestsClient): NIP-98 auth + nests room-info client

Phase 3a of the Clubhouse/nests integration. Adds a new KMP module `nestsClient` (Android + JVM targets) that owns the HTTP control plane for talking to a nests audio-room backend. No transport/audio yet — that arrives in 3b with WebTransport + MoQ. Surface: - `NestsAuth.header(signer, url, method)` signs a kind 27235 event via Quartz's existing HTTPAuthorizationEvent and returns a ready-to-use `Authorization: Nostr <base64>` header value. - `NestsRoomInfo` data class + tolerant JSON parser (ignores unknown fields so newer nests server revisions don't break older clients). - `NestsClient.resolveRoom(serviceBase, roomId, signer)` calls `<serviceBase>/<roomId>` with the signed NIP-98 header and returns the MoQ endpoint + token the audio layer will need. - `OkHttpNestsClient` (jvmAndroid) is the default implementation shared between Android and desktop JVM. Tests: - `NestsRoomInfoTest` (commonTest) covers full/minimal payloads, unknown-field tolerance, missing-endpoint rejection, and URL construction edge cases. - `NestsAuthTest` (jvmTest) signs a real 27235 event, decodes the base64 back through Quartz's JacksonMapper, and asserts the signature verifies and the url+method tags bind correctly. https://claude.ai/code/session_013nVLALALKaHVgHm9u5Cg8D
2026-04-22 02:58:24 +00:00
parent 0db80c66b8
commit 933b522273
8 changed files with 519 additions and 0 deletions
@@ -0,0 +1,90 @@
+/*
+ * 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.nestsclient
+
+import kotlin.test.Test
+import kotlin.test.assertEquals
+import kotlin.test.assertFailsWith
+import kotlin.test.assertNull
+
+class NestsRoomInfoTest {
+    @Test
+    fun parses_full_payload() {
+        val info =
+            NestsRoomInfo.parse(
+                """{"endpoint":"https://relay.example.com/moq","token":"abc.def","codec":"opus","sample_rate":48000,"transport":"webtransport"}""",
+            )
+        assertEquals("https://relay.example.com/moq", info.endpoint)
+        assertEquals("abc.def", info.token)
+        assertEquals("opus", info.codec)
+        assertEquals(48000, info.sampleRate)
+        assertEquals("webtransport", info.transport)
+    }
+
+    @Test
+    fun tolerates_minimal_payload() {
+        val info = NestsRoomInfo.parse("""{"endpoint":"https://r.example.com/moq"}""")
+        assertEquals("https://r.example.com/moq", info.endpoint)
+        assertNull(info.token)
+        assertNull(info.codec)
+        assertNull(info.sampleRate)
+    }
+
+    @Test
+    fun ignores_unknown_fields() {
+        val info =
+            NestsRoomInfo.parse(
+                """{"endpoint":"https://r.example.com/moq","token":"t","future_knob":"future_value"}""",
+            )
+        assertEquals("t", info.token)
+    }
+
+    @Test
+    fun rejects_missing_endpoint() {
+        assertFailsWith<Exception> {
+            NestsRoomInfo.parse("""{"token":"t"}""")
+        }
+    }
+
+    @Test
+    fun builds_room_info_url_from_service_and_room_id() {
+        assertEquals(
+            "https://nostrnests.com/api/v1/nests/abc-123",
+            nestsRoomInfoUrl("https://nostrnests.com/api/v1/nests", "abc-123"),
+        )
+    }
+
+    @Test
+    fun trims_trailing_slash_from_service_base() {
+        assertEquals(
+            "https://nostrnests.com/api/v1/nests/xyz",
+            nestsRoomInfoUrl("https://nostrnests.com/api/v1/nests/", "xyz"),
+        )
+    }
+
+    @Test
+    fun trims_whitespace_from_room_id() {
+        assertEquals(
+            "https://a.example.com/api/v1/nests/room",
+            nestsRoomInfoUrl("https://a.example.com/api/v1/nests", "  room  "),
+        )
+    }
+}