feat: client access functionality (sourceplusplus/sourceplusplus#504)

Author: BFergerson

codegen/src/main/resources/META-INF/vertx/json-mappers.properties

@@ -32,3 +32,5 @@ spp.protocol.instrument.event.LiveBreakpointHit.serializer=spp.protocol.marshall
 spp.protocol.instrument.event.LiveBreakpointHit.deserializer=spp.protocol.marshall.ProtocolMarshaller#deserializeLiveBreakpointHit
 spp.protocol.platform.auth.DeveloperRole.serializer=spp.protocol.marshall.ProtocolMarshaller#serializeDeveloperRole
 spp.protocol.platform.auth.DeveloperRole.deserializer=spp.protocol.marshall.ProtocolMarshaller#deserializeDeveloperRole
+spp.protocol.platform.auth.ClientAccess.serializer=spp.protocol.marshall.ProtocolMarshaller#serializeClientAccess
+spp.protocol.platform.auth.ClientAccess.deserializer=spp.protocol.marshall.ProtocolMarshaller#deserializeClientAccess

src/jvmMain/kotlin/spp/protocol/SourceServices.kt

@@ -45,6 +45,7 @@ object SourceServices {
     }
 
     object Utilize {
+        const val LIVE_MANAGEMENT_SERVICE = "spp.service.live-management-service"
         const val LIVE_SERVICE = "spp.service.live-service"
         const val LIVE_INSTRUMENT = "spp.service.live-instrument"
         const val LIVE_VIEW = "spp.service.live-view"

src/jvmMain/kotlin/spp/protocol/marshall/ProtocolMarshaller.kt

@@ -38,6 +38,7 @@ import spp.protocol.instrument.event.LiveBreakpointHit
 import spp.protocol.instrument.event.LiveInstrumentRemoved
 import spp.protocol.instrument.event.LiveLogHit
 import spp.protocol.instrument.variable.LiveVariable
+import spp.protocol.platform.auth.ClientAccess
 import spp.protocol.platform.auth.DataRedaction
 import spp.protocol.platform.auth.DeveloperRole
 import spp.protocol.platform.auth.RedactionType
@@ -438,4 +439,17 @@ object ProtocolMarshaller {
             value.getBoolean("nativeRole")
         )
     }
+
+    @JvmStatic
+    fun serializeClientAccess(value: ClientAccess): JsonObject {
+        return JsonObject(Json.encode(value))
+    }
+
+    @JvmStatic
+    fun deserializeClientAccess(value: JsonObject): ClientAccess {
+        return ClientAccess(
+            value.getString("id"),
+            value.getString("secret")
+        )
+    }
 }

src/jvmMain/kotlin/spp/protocol/service/LiveManagementService.kt

@@ -0,0 +1,38 @@
+package spp.protocol.service
+
+import io.vertx.codegen.annotations.GenIgnore
+import io.vertx.codegen.annotations.ProxyGen
+import io.vertx.codegen.annotations.VertxGen
+import io.vertx.core.Future
+import io.vertx.core.Vertx
+import io.vertx.core.eventbus.DeliveryOptions
+import spp.protocol.SourceServices.Utilize.LIVE_MANAGEMENT_SERVICE
+import spp.protocol.platform.auth.ClientAccess
+
+
+/**
+ * todo: description.
+ *
+ * @author [Brandon Fergerson](mailto:bfergerson@apache.org)
+ */
+@ProxyGen
+@VertxGen
+interface LiveManagementService {
+
+    @GenIgnore
+    companion object {
+        @JvmStatic
+        fun createProxy(vertx: Vertx, authToken: String? = null): LiveManagementService {
+            val deliveryOptions = DeliveryOptions().apply {
+                authToken?.let { addHeader("auth-token", it) }
+            }
+            return LiveManagementServiceVertxEBProxy(vertx, LIVE_MANAGEMENT_SERVICE, deliveryOptions)
+        }
+    }
+
+    fun getClientAccessors(): Future<List<ClientAccess>>
+    fun getClientAccess(id: String): Future<ClientAccess?>
+    fun addClientAccess(): Future<ClientAccess>
+    fun removeClientAccess(id: String): Future<Boolean>
+    fun updateClientAccess(id: String): Future<ClientAccess>
+}