Merge pull request #826 from appwrite/feat-warn-response-format

feat: warn response format

Author: abnegate

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

@@ -473,6 +473,14 @@ class Client @JvmOverloads constructor(
                     it.cancel(error)
                     return
                 }
+
+                val warnings = response.headers["x-{{ spec.title | lower }}-warning"]
+                if (warnings != null) {
+                    warnings.split(";").forEach { warning ->
+                        println("Warning: $warning")
+                    }
+                }
+
                 when {
                     responseType == Boolean::class.java -> {
                         it.resume(true as T)

templates/apple/Sources/Client.swift.twig

@@ -278,6 +278,12 @@ open class Client {
             timeout: .seconds(30)
         )
 
+        if let warning = response.headers["x-{{ spec.title | lower }}-warning"].first {
+            warning.split(separator: ";").forEach { warning in
+                print("Warning: \(warning)")
+            }
+        }
+
         switch response.status.code {
         case 0..<400:
             if response.headers["Set-Cookie"].count > 0 {

templates/cli/lib/client.js.twig

@@ -132,6 +132,11 @@ class Client {
             },
         }),
       });
+
+      const warnings = response.headers.get('x-{{ spec.title | lower }}-warning');
+      if (warnings) {
+          warnings.split(';').forEach((warning) => console.warn(warning));
+      }
     } catch (error) {
       throw new {{spec.title | caseUcfirst}}Exception(error.message);
     }

templates/dart/lib/src/client_mixin.dart.twig

@@ -2,6 +2,7 @@ import 'package:http/http.dart' as http;
 import 'exception.dart';
 import 'response.dart';
 import 'dart:convert';
+import 'dart:developer';
 import 'enums.dart';
 
 class ClientMixin {
@@ -67,6 +68,12 @@ class ClientMixin {
 
   Response prepareResponse(http.Response res, {ResponseType? responseType}) {
     responseType ??= ResponseType.json;
+
+    String? warnings = res.headers['x-{{ spec.title | lower }}-warning'];
+    if (warnings != null) {
+      warnings.split(';').forEach((warning) => log('Warning: $warning'));
+    }
+
     if (res.statusCode >= 400) {
       if ((res.headers['content-type'] ?? '').contains('application/json')) {
         final response = json.decode(res.body);

templates/deno/src/client.ts.twig

@@ -96,6 +96,11 @@ export class Client {
                 headers,
                 body
             });
+
+            const warnings = response.headers.get('x-{{ spec.title | lower }}-warning');
+            if (warnings) {
+                warnings.split(';').forEach((warning: string) => console.warn('Warning: ' + warning));
+            }
         } catch (error) {
             throw new {{spec.title | caseUcfirst}}Exception(error.message);
         }

templates/dotnet/Package/Client.cs.twig

@@ -269,6 +269,14 @@ namespace {{ spec.title | caseUcfirst }}
             var response = await _http.SendAsync(request);
             var code = (int)response.StatusCode;
 
+            if (response.Headers.TryGetValues("x-{{ spec.title | lower }}-warning", out var warnings)) 
+            {
+                foreach (var warning in warnings)
+                {
+                    Console.WriteLine("Warning: " + warning);
+                }
+            }
+
             string contentType = string.Empty;
             if (response.Content.Headers.TryGetValues("Content-Type", out var contentTypes))
             {

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

@@ -2,6 +2,7 @@ import 'package:http/http.dart' as http;
 import 'exception.dart';
 import 'response.dart';
 import 'dart:convert';
+import 'dart:developer';
 import 'enums.dart';
 
 class ClientMixin {
@@ -67,6 +68,12 @@ class ClientMixin {
 
   Response prepareResponse(http.Response res, {ResponseType? responseType}) {
     responseType ??= ResponseType.json;
+
+    String? warnings = res.headers['x-{{ spec.title | lower }}-warning'];
+    if (warnings != null) {
+      warnings.split(';').forEach((warning) => log('Warning: $warning'));
+    }
+
     if (res.statusCode >= 400) {
       if ((res.headers['content-type'] ?? '').contains('application/json')) {
         final response = json.decode(res.body);

templates/kotlin/src/main/kotlin/io/appwrite/Client.kt.twig

@@ -523,6 +523,14 @@ class Client @JvmOverloads constructor(
                     it.cancel(error)
                     return
                 }
+
+                val warnings = response.headers["x-{{ spec.title | lower }}-warning"]
+                if (warnings != null) {
+                    warnings.split(";").forEach { warning ->
+                        println("Warning: $warning")
+                    }
+                }
+
                 when {
                     responseType == Boolean::class.java -> {
                         it.resume(true as T)

templates/node/src/client.ts.twig

@@ -262,6 +262,11 @@ class Client {
 
         const response = await fetch(uri, options);
 
+        const warnings = response.headers.get('x-{{ spec.title | lower }}-warning');
+        if (warnings) {
+            warnings.split(';').forEach((warning: string) => console.warn('Warning: ' + warning));
+        }
+
         if (response.headers.get('content-type')?.includes('application/json')) {
             data = await response.json();
         } else if (responseType === 'arrayBuffer') {

templates/php/src/Client.php.twig

@@ -176,6 +176,13 @@ class Client
         $responseBody   = curl_exec($ch);
         $contentType    = $responseHeaders['content-type'] ?? '';
         $responseStatus = curl_getinfo($ch, CURLINFO_HTTP_CODE);
+
+        $warnings = $responseHeaders['x-{{spec.title | caseLower}}-warning'] ?? '';
+        if ($warnings) {
+            foreach(explode(';', $warnings) as $warning) {
+                echo 'Warning: ' . $warning . PHP_EOL;
+            }
+        }
         
         switch(substr($contentType, 0, strpos($contentType, ';'))) {
             case 'application/json':