add: ping to android kotlin.

Author: ItzNotABug

templates/android/library/src/main/java/io/package/Client.kt.twig

@@ -211,6 +211,25 @@ class Client @JvmOverloads constructor(
         return this
     }
 
+    /**
+     * Sends a "ping" request to Appwrite to verify connectivity.
+     *
+     * @return String
+     */
+    suspend fun ping(): String {
+        val apiPath = "/ping"
+        val apiParams = mutableMapOf<String, Any?>()
+        val apiHeaders = mutableMapOf("content-type" to "application/json")
+
+        return call(
+            "GET",
+            apiPath,
+            apiHeaders,
+            apiParams,
+            responseType = String::class.java
+        )
+    }
+
     /**
      * Send the HTTP request
      * 
@@ -489,6 +508,14 @@ class Client @JvmOverloads constructor(
                         it.resume(true as T)
                         return
                     }
+                    responseType == String::class.java -> {
+                        val body = response.body!!
+                            .charStream()
+                            .buffered()
+                            .use(BufferedReader::readText)
+                        it.resume(body as T)
+                        return
+                    }
                     responseType == ByteArray::class.java -> {
                         it.resume(response.body!!
                             .byteStream()

tests/Android14Java11Test.php

@@ -20,6 +20,7 @@ class Android14Java11Test extends Base
         'docker run --network="mockapi" --rm -v $(pwd):/app -w /app/tests/sdks/android alvrme/alpine-android:android-34-jdk11 sh -c "./gradlew :library:testReleaseUnitTest --stacktrace -q && cat library/result.txt"';
 
     protected array $expectedOutput = [
+        ...Base::PING_RESPONSE,
         ...Base::FOO_RESPONSES,
         ...Base::BAR_RESPONSES,
         ...Base::GENERAL_RESPONSES,

tests/Android14Java17Test.php

@@ -20,6 +20,7 @@ class Android14Java17Test extends Base
         'docker run --rm --network="mockapi" -v $(pwd):/app -w /app/tests/sdks/android alvrme/alpine-android:android-34-jdk17 sh -c "./gradlew :library:testReleaseUnitTest --stacktrace -q && cat library/result.txt"';
 
     protected array $expectedOutput = [
+        ...Base::PING_RESPONSE,
         ...Base::FOO_RESPONSES,
         ...Base::BAR_RESPONSES,
         ...Base::GENERAL_RESPONSES,

tests/Android14Java8Test.php

@@ -20,6 +20,7 @@ class Android14Java8Test extends Base
         'docker run --network="mockapi" --rm -v $(pwd):/app -w /app/tests/sdks/android alvrme/alpine-android:android-34-jdk8 sh -c "./gradlew :library:testReleaseUnitTest --stacktrace -q && cat library/result.txt"';
 
     protected array $expectedOutput = [
+        ...Base::PING_RESPONSE,
         ...Base::FOO_RESPONSES,
         ...Base::BAR_RESPONSES,
         ...Base::GENERAL_RESPONSES,

tests/Android5Java17Test.php

@@ -20,6 +20,7 @@ class Android5Java17Test extends Base
         'docker run --network="mockapi" --rm -v $(pwd):/app -w /app/tests/sdks/android alvrme/alpine-android:android-21-jdk17 sh -c "./gradlew :library:testReleaseUnitTest --stacktrace -q && cat library/result.txt"';
 
     protected array $expectedOutput = [
+        ...Base::PING_RESPONSE,
         ...Base::FOO_RESPONSES,
         ...Base::BAR_RESPONSES,
         ...Base::GENERAL_RESPONSES,

tests/languages/android/Tests.kt

@@ -29,6 +29,7 @@ import org.junit.After
 import org.junit.Before
 import org.junit.Test
 import org.junit.runner.RunWith
+import org.json.JSONObject
 import org.robolectric.annotation.Config
 import java.io.File
 import java.io.IOException
@@ -61,10 +62,20 @@ class ServiceTest {
     @Throws(IOException::class)
     fun test() {
         val client = Client(ApplicationProvider.getApplicationContext())
-            .setEndpointRealtime("wss://cloud.appwrite.io/v1")
-            .setProject("console")
+            .setProject("123456")
             .addHeader("Origin", "http://localhost")
             .setSelfSigned(true)
+
+        runBlocking {
+            val ping = client.ping()
+            val pingResponse = parse(ping)
+            writeToFile(pingResponse)
+        }
+
+        // reset configs
+        client.setProject("console")
+            .setEndpointRealtime("wss://cloud.appwrite.io/v1")
+
         val foo = Foo(client)
         val bar = Bar(client)
         val general = General(client)
@@ -219,4 +230,11 @@ class ServiceTest {
         File("result.txt").appendText(text)
     }
 
+    private fun parse(json: String): String? {
+        return try {
+            JSONObject(json).getString("result")
+        } catch (exception: Exception) {
+            null
+        }
+    }
 }