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,78 @@
+/*
+ * 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 com.vitorpamplona.quartz.nip01Core.signers.NostrSigner
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+import okhttp3.OkHttpClient
+import okhttp3.Request
+import java.io.IOException
+
+/**
+ * OkHttp-backed [NestsClient] used on JVM + Android. A shared [OkHttpClient]
+ * can be injected so the app reuses connection pools / interceptors across
+ * the process; the default constructor creates a dedicated client.
+ */
+class OkHttpNestsClient(
+    private val http: OkHttpClient = OkHttpClient(),
+) : NestsClient {
+    override suspend fun resolveRoom(
+        serviceBase: String,
+        roomId: String,
+        signer: NostrSigner,
+    ): NestsRoomInfo {
+        val url = nestsRoomInfoUrl(serviceBase, roomId)
+        val authHeader = NestsAuth.header(signer = signer, url = url, method = "GET")
+
+        val request =
+            Request
+                .Builder()
+                .url(url)
+                .get()
+                .header("Authorization", authHeader)
+                .header("Accept", "application/json")
+                .build()
+
+        return withContext(Dispatchers.IO) {
+            runCatching { http.newCall(request).execute() }
+                .getOrElse { throw NestsException("Failed to reach $url", it) }
+                .use { response ->
+                    val body = response.body.string()
+                    if (!response.isSuccessful) {
+                        throw NestsException(
+                            "nests server returned ${response.code} for $url",
+                            status = response.code,
+                        )
+                    }
+                    try {
+                        NestsRoomInfo.parse(body)
+                    } catch (e: IOException) {
+                        throw NestsException("Malformed nests response from $url", e)
+                    } catch (e: IllegalArgumentException) {
+                        throw NestsException("Malformed nests response from $url", e)
+                    } catch (e: kotlinx.serialization.SerializationException) {
+                        throw NestsException("Malformed nests response from $url", e)
+                    }
+                }
+        }
+    }
+}