Implement report endpoint

Author: rubengees

library/src/main/kotlin/me/proxer/library/api/messenger/InternalApi.kt

@@ -77,4 +77,8 @@ internal interface InternalApi {
     @FormUrlEncoded
     @POST("messenger/setunfavour")
     fun unmarkConferenceAsFavorite(@Field("conference_id") id: String?): ProxerCall<Unit>
+
+    @FormUrlEncoded
+    @POST("messenger/report")
+    fun report(@Field("conference_id") id: String?, @Field("text") text: String?): ProxerCall<Unit>
 }

library/src/main/kotlin/me/proxer/library/api/messenger/MessengerApi.kt

@@ -109,6 +109,13 @@ class MessengerApi internal constructor(retrofit: Retrofit) {
         return ConferenceModificationEndpoint(internalApi, id, ConferenceModification.UNFAVOUR)
     }
 
+    /**
+     * Returns the respective endpoint.
+     */
+    fun report(id: String, text: String): ReportConferenceEndpoint {
+        return ReportConferenceEndpoint(internalApi, id, text)
+    }
+
     private fun constructMessageFromAction(action: MessageAction, subject: String): String {
         require(action != MessageAction.NONE) { "Invalid action: $action" }
 

library/src/main/kotlin/me/proxer/library/api/messenger/ReportConferenceEndpoint.kt

@@ -0,0 +1,20 @@
+package me.proxer.library.api.messenger
+
+import me.proxer.library.ProxerCall
+import me.proxer.library.api.Endpoint
+
+/**
+ * Endpoint for reporting a conference. The given text is sent to the moderators for investigation.
+ *
+ * @author Ruben Gees
+ */
+class ReportConferenceEndpoint internal constructor(
+    private val internalApi: InternalApi,
+    private val conferenceId: String,
+    private val text: String
+) : Endpoint<Unit> {
+
+    override fun build(): ProxerCall<Unit> {
+        return internalApi.report(conferenceId, text)
+    }
+}

library/src/test/kotlin/me/proxer/library/api/messenger/ReportConferenceEndpointTest.kt

@@ -0,0 +1,44 @@
+package me.proxer.library.api.messenger
+
+import me.proxer.library.ProxerTest
+import me.proxer.library.runRequest
+import org.amshove.kluent.shouldBeEqualTo
+import org.amshove.kluent.shouldBeNull
+import org.junit.jupiter.api.Test
+
+class ReportConferenceEndpointTest : ProxerTest() {
+
+    @Test
+    fun testDefault() {
+        val (result, _) = server.runRequest("empty.json") {
+            api.messenger
+                .report("123", "evil user")
+                .build()
+                .execute()
+        }
+
+        result.shouldBeNull()
+    }
+
+    @Test
+    fun testPath() {
+        val (_, request) = server.runRequest("empty.json") {
+            api.messenger.report("123", "test")
+                .build()
+                .execute()
+        }
+
+        request.path shouldBeEqualTo "/api/v1/messenger/report"
+    }
+
+    @Test
+    fun testParameters() {
+        val (_, request) = server.runRequest("empty.json") {
+            api.messenger.report("id", "report")
+                .build()
+                .execute()
+        }
+
+        request.body.readUtf8() shouldBeEqualTo "conference_id=id&text=report"
+    }
+}