Merge pull request #1016 from ItzNotABug/add-ping-to-mobile-sdks

Add `ping` to Mobile and other SDKs

Author: christyjacob4

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()

templates/apple/Sources/Client.swift.twig

@@ -214,6 +214,26 @@ open class Client {
        ) ?? ""
    }
 
+    ///
+    /// Sends a "ping" request to Appwrite to verify connectivity.
+    ///
+    /// @return String
+    /// @throws Exception
+    ///
+   open func ping() async throws -> String {
+       let apiPath: String = "/ping"
+
+       let apiHeaders: [String: String] = [
+           "content-type": "application/json"
+       ]
+
+       return try await call(
+           method: "GET",
+           path: apiPath,
+           headers: apiHeaders
+       )
+    }
+
     ///
     /// Make an API call
     ///
@@ -284,6 +304,8 @@ open class Client {
             }
         }
 
+        var data = try await response.body.collect(upTo: Int.max)
+
         switch response.status.code {
         case 0..<400:
             if response.headers["Set-Cookie"].count > 0 {
@@ -296,10 +318,11 @@ open class Client {
             switch T.self {
             case is Bool.Type:
                 return true as! T
+            case is String.Type:
+                return (data.readString(length: data.readableBytes) ?? "") as! T
             case is ByteBuffer.Type:
-                return try await response.body.collect(upTo: Int.max) as! T
+                return data as! T
             default:
-                let data = try await response.body.collect(upTo: Int.max)
                 if data.readableBytes == 0 {
                     return true as! T
                 }
@@ -309,7 +332,6 @@ open class Client {
             }
         default:
             var message = ""
-            var data = try await response.body.collect(upTo: Int.max)
             var type = ""
 
             do {

templates/dart/lib/src/client.dart.twig

@@ -48,6 +48,9 @@ abstract class Client {
   /// Add headers that should be sent with all API calls.
   Client addHeader(String key, String value);
 
+  /// Sends a "ping" request to Appwrite to verify connectivity.
+  Future<String> ping();
+
   /// Upload a file in chunks.
   Future<Response> chunkedUpload({
     required String path,

templates/dart/lib/src/client_base.dart.twig

@@ -20,6 +20,9 @@ abstract class ClientBase implements Client {
   @override
   ClientBase addHeader(String key, String value);
 
+  @override
+  Future<String> ping();
+
   @override
   Future<Response> call(
     HttpMethod method, {

templates/dart/lib/src/client_browser.dart.twig

@@ -77,6 +77,14 @@ class ClientBrowser extends ClientBase with ClientMixin {
     return this;
   }
 
+  @override
+  Future<String> ping() async {
+    final String apiPath = '/ping';
+    final response = await call(HttpMethod.get, path: apiPath, responseType: ResponseType.plain);
+
+    return response.data;
+  }
+
   @override
   Future<String?> webAuth(Uri url) async {
     final request = http.Request('GET', url);

templates/dart/lib/src/client_io.dart.twig

@@ -89,6 +89,14 @@ class ClientIO extends ClientBase with ClientMixin {
     return this;
   }
 
+  @override
+  Future<String> ping() async {
+    final String apiPath = '/ping';
+    final response = await call(HttpMethod.get, path: apiPath, responseType: ResponseType.plain);
+
+    return response.data;
+  }
+
   @override
   Future<Response> chunkedUpload({
     required String path,

templates/flutter/lib/src/client.dart.twig

@@ -65,6 +65,9 @@ abstract class Client {
   /// Add headers that should be sent with all API calls.
   Client addHeader(String key, String value);
 
+  /// Sends a "ping" request to Appwrite to verify connectivity.
+  Future<String> ping();
+
   /// Send the API request.
   Future<Response> call(HttpMethod method, {
     String path = '',

templates/flutter/lib/src/client_base.dart.twig

@@ -23,6 +23,9 @@ abstract class ClientBase implements Client {
   @override
   ClientBase addHeader(String key, String value);
 
+  @override
+  Future<String> ping();
+
   @override
   Future<Response> call(
     HttpMethod method, {

templates/flutter/lib/src/client_browser.dart.twig

@@ -98,6 +98,14 @@ class ClientBrowser extends ClientBase with ClientMixin {
     return this;
   }
 
+  @override
+  Future<String> ping() async {
+    final String apiPath = '/ping';
+    final response = await call(HttpMethod.get, path: apiPath, responseType: ResponseType.plain);
+
+    return response.data;
+  }
+
   Future init() async {
     final cookieFallback = web.window.localStorage['cookieFallback'];
     if (cookieFallback != null) {

templates/flutter/lib/src/client_io.dart.twig

@@ -130,6 +130,14 @@ class ClientIO extends ClientBase with ClientMixin {
     return this;
   }
 
+  @override
+  Future<String> ping() async {
+    final String apiPath = '/ping';
+    final response = await call(HttpMethod.get, path: apiPath, responseType: ResponseType.plain);
+
+    return response.data;
+  }
+
   Future init() async {
     if(_initProgress) return;
     _initProgress = true;