Merge pull request #1405 from appwrite/feat/sdk-header-getters

Add header getters across generated SDKs

Author: ChiragAgg5k

example.php

@@ -56,8 +56,22 @@ function configureSDK($sdk, $overrides = []) {
             'twitter' => 'appwrite',
             'discord' => ['564160730845151244', 'https://appwrite.io/discord'],
             'readme' => '**README**',
+            'exclude' => [
+                'services' => [
+                    ['name' => 'documentsDB'],
+                    ['name' => 'vectorsDB'],
+                ],
+            ],
         ];
 
+        // Deep-merge exclude services so overrides add to defaults rather than replacing
+        if (isset($overrides['exclude']['services']) && isset($defaults['exclude']['services'])) {
+            $overrides['exclude']['services'] = array_merge(
+                $defaults['exclude']['services'],
+                $overrides['exclude']['services']
+            );
+        }
+
         $config = array_merge($defaults, $overrides);
 
         $sdk->setName($config['name'])
@@ -99,7 +113,7 @@ function configureSDK($sdk, $overrides = []) {
         // $platform = 'server';
     }
 
-    $version = '1.8.x';
+    $version = '1.9.x';
     $speclessSDKs = ['agent-skills', 'cursor-plugin'];
     $needsSpec = !$requestedSdk || !in_array($requestedSdk, $speclessSDKs);
 

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

@@ -219,6 +219,28 @@ class Client @JvmOverloads constructor(
         return this
     }
 
+    /**
+     * Get the current request headers used for Appwrite API calls.
+     *
+     * @return a copy of the current request headers
+     */
+    fun getHeaders(): Map<String, String> = headers.toMap()
+
+    /**
+     * Get the cookies for a given URL from the SDK's cookie store.
+     *
+     * @param url the URL to retrieve cookies for
+     * @return a list of cookies for the given URL
+     */
+    fun getCookies(url: String): List<Cookie> = cookieJar.loadForRequest(url.toHttpUrl())
+
+    /**
+     * Get the OkHttpClient instance used by this SDK.
+     *
+     * @return the OkHttpClient instance used by this client
+     */
+    fun getHttpClient(): OkHttpClient = http
+
     /**
      * Sends a "ping" request to Appwrite to verify connectivity.
      *

templates/apple/Sources/Client.swift.twig

@@ -178,6 +178,10 @@ open class Client {
         return self
     }
 
+    open func getHeaders() -> [String: String] {
+        return self.headers
+    }
+
    ///
    /// Builds a query string from parameters
    ///

templates/cli/lib/client.ts

@@ -156,6 +156,10 @@ class Client {
     return this;
   }
 
+  getHeaders(): Headers {
+    return { ...this.headers };
+  }
+
   async call<T = unknown>(
     method: string,
     path: string = "",

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);
 
+  /// Get the current request headers.
+  Map<String, String> getHeaders();
+
   /// Sends a "ping" request to Appwrite to verify connectivity.
   Future<String> ping();
 

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
+  Map<String, String> getHeaders();
+
   @override
   Future<String> ping() async {
     final String apiPath = '/ping';

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

@@ -81,6 +81,11 @@ class ClientBrowser extends ClientBase with ClientMixin {
     return this;
   }
 
+  @override
+  Map<String, String> getHeaders() {
+    return Map<String, String>.from(_headers!);
+  }
+
   @override
   Future<String?> webAuth(Uri url) async {
     final request = http.Request('GET', url);

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

@@ -93,6 +93,11 @@ class ClientIO extends ClientBase with ClientMixin {
     return this;
   }
 
+  @override
+  Map<String, String> getHeaders() {
+    return Map<String, String>.from(_headers!);
+  }
+
   @override
   Future<Response> chunkedUpload({
     required String path,

templates/deno/src/client.ts.twig

@@ -68,6 +68,10 @@ export class Client {
         return this;
     }
 
+    getHeaders(): Payload {
+        return { ...this.headers };
+    }
+
     async call(method: string, path: string = "", headers: Payload = {}, params: Payload = {}, responseType: string = "json") {
         headers = {...this.headers, ...headers};
         const url = new URL(this.endpoint + path);
@@ -156,4 +160,4 @@ export class Client {
 
         return output;
     }
-}
+}

templates/dotnet/Package/Client.cs.twig

@@ -131,6 +131,11 @@ namespace {{ spec.title | caseUcfirst }}
             return this;
         }
 
+        public Dictionary<string, string> GetHeaders()
+        {
+            return new Dictionary<string, string>(_headers);
+        }
+
         private HttpRequestMessage PrepareRequest(
             string method,
             string path,