feat(quic): Phase A — module foundations

Create the new :quic Gradle module (KMP, api(project(":quartz"))) and migrate the QUIC varint codec out of :nestsClient where it was incidentally living. Add the connection-ID, packet-number-space, and UDP socket primitives that the rest of the QUIC client will build on. Layer-by-layer plan in docs/plans/2026-04-22-pure-kotlin-quic-webtransport-plan.md. - New :quic module wired into settings.gradle, with commonMain + jvmAndroid source sets mirroring :quartz's structure. - Varint moves from com.vitorpamplona.nestsclient.moq to com.vitorpamplona.quic; MoqBuffer/MoqCodec updated to import the new path. - ConnectionId enforces the 0..20 byte length range and ships a randomizer backed by Quartz's RandomInstance. - PacketNumberSpaceState tracks per-space outbound allocation + largest-received tracking, and implements the RFC 9000 §A.3 truncated-PN decode formula plus the §17.1 minimum encode-length picker. - UdpSocket is an expect class with a connected DatagramChannel actual on jvmAndroid using Dispatchers.IO (no Selector — one socket per connection). All 12 tests pass on jvmTest. RFC 9000 §A.1 varint vectors and §A.3 truncated-PN vector match bit-for-bit. https://claude.ai/code/session_01EC1tfXfap8k8GyKvrxkxZx
2026-04-25 17:19:02 +00:00
parent 41c1e131a0
commit 2d541c6fd4
13 changed files with 620 additions and 16 deletions
@@ -0,0 +1,98 @@
+/*
+ * 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.
+ */
+import org.jetbrains.kotlin.gradle.dsl.JvmTarget
+
+plugins {
+    alias(libs.plugins.kotlinMultiplatform)
+    alias(libs.plugins.androidKotlinMultiplatformLibrary)
+}
+
+kotlin {
+    jvm {
+        compilerOptions {
+            jvmTarget.set(JvmTarget.JVM_21)
+        }
+    }
+
+    android {
+        namespace = "com.vitorpamplona.quic"
+        compileSdk =
+            libs.versions.android.compileSdk
+                .get()
+                .toInt()
+        minSdk =
+            libs.versions.android.minSdk
+                .get()
+                .toInt()
+
+        compilerOptions {
+            jvmTarget.set(JvmTarget.JVM_21)
+        }
+
+        withHostTest {}
+    }
+
+    sourceSets {
+        commonMain {
+            dependencies {
+                implementation(libs.kotlin.stdlib)
+                implementation(libs.kotlinx.coroutines.core)
+                api(project(":quartz"))
+            }
+        }
+
+        commonTest {
+            dependencies {
+                implementation(libs.kotlin.test)
+                implementation(libs.kotlinx.coroutines.test)
+            }
+        }
+
+        val jvmAndroid =
+            create("jvmAndroid") {
+                dependsOn(commonMain.get())
+            }
+
+        jvmMain {
+            dependsOn(jvmAndroid)
+        }
+
+        androidMain {
+            dependsOn(jvmAndroid)
+        }
+
+        jvmTest {
+            dependencies {
+                implementation(libs.kotlin.test)
+                implementation(libs.kotlinx.coroutines.test)
+                implementation(libs.secp256k1.kmp.jni.jvm)
+            }
+        }
+
+        getByName("androidHostTest") {
+            dependencies {
+                implementation(libs.kotlin.test)
+                implementation(libs.kotlinx.coroutines.test)
+                implementation(libs.secp256k1.kmp.jni.jvm)
+            }
+        }
+    }
+}