feat: API specs update for version 1.9.x

examples/1.9.x/client-android/java/presences/delete.md

@@ -0,0 +1,24 @@
+```java
+import io.appwrite.Client;
+import io.appwrite.coroutines.CoroutineCallback;
+import io.appwrite.services.Presences;
+
+Client client = new Client(context)
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>"); // Your project ID
+
+Presences presences = new Presences(client);
+
+presences.delete(
+    "<PRESENCE_ID>", // presenceId 
+    new CoroutineCallback<>((result, error) -> {
+        if (error != null) {
+            error.printStackTrace();
+            return;
+        }
+
+        Log.d("Appwrite", result.toString());
+    })
+);
+
+```

examples/1.9.x/client-android/java/presences/get.md

@@ -0,0 +1,24 @@
+```java
+import io.appwrite.Client;
+import io.appwrite.coroutines.CoroutineCallback;
+import io.appwrite.services.Presences;
+
+Client client = new Client(context)
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>"); // Your project ID
+
+Presences presences = new Presences(client);
+
+presences.get(
+    "<PRESENCE_ID>", // presenceId 
+    new CoroutineCallback<>((result, error) -> {
+        if (error != null) {
+            error.printStackTrace();
+            return;
+        }
+
+        Log.d("Appwrite", result.toString());
+    })
+);
+
+```

examples/1.9.x/client-android/java/presences/list.md

@@ -0,0 +1,26 @@
+```java
+import io.appwrite.Client;
+import io.appwrite.coroutines.CoroutineCallback;
+import io.appwrite.services.Presences;
+
+Client client = new Client(context)
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>"); // Your project ID
+
+Presences presences = new Presences(client);
+
+presences.list(
+    List.of(), // queries (optional)
+    false, // total (optional)
+    0, // ttl (optional)
+    new CoroutineCallback<>((result, error) -> {
+        if (error != null) {
+            error.printStackTrace();
+            return;
+        }
+
+        Log.d("Appwrite", result.toString());
+    })
+);
+
+```

examples/1.9.x/client-android/java/presences/update.md

@@ -0,0 +1,31 @@
+```java
+import io.appwrite.Client;
+import io.appwrite.coroutines.CoroutineCallback;
+import io.appwrite.Permission;
+import io.appwrite.Role;
+import io.appwrite.services.Presences;
+
+Client client = new Client(context)
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>"); // Your project ID
+
+Presences presences = new Presences(client);
+
+presences.update(
+    "<PRESENCE_ID>", // presenceId 
+    "<STATUS>", // status (optional)
+    "2020-10-15T06:38:00.000+00:00", // expiresAt (optional)
+    Map.of("a", "b"), // metadata (optional)
+    List.of(Permission.read(Role.any())), // permissions (optional)
+    false, // purge (optional)
+    new CoroutineCallback<>((result, error) -> {
+        if (error != null) {
+            error.printStackTrace();
+            return;
+        }
+
+        Log.d("Appwrite", result.toString());
+    })
+);
+
+```

examples/1.9.x/client-android/java/presences/upsert.md

@@ -0,0 +1,30 @@
+```java
+import io.appwrite.Client;
+import io.appwrite.coroutines.CoroutineCallback;
+import io.appwrite.Permission;
+import io.appwrite.Role;
+import io.appwrite.services.Presences;
+
+Client client = new Client(context)
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>"); // Your project ID
+
+Presences presences = new Presences(client);
+
+presences.upsert(
+    "<PRESENCE_ID>", // presenceId 
+    "<STATUS>", // status 
+    List.of(Permission.read(Role.any())), // permissions (optional)
+    "2020-10-15T06:38:00.000+00:00", // expiresAt (optional)
+    Map.of("a", "b"), // metadata (optional)
+    new CoroutineCallback<>((result, error) -> {
+        if (error != null) {
+            error.printStackTrace();
+            return;
+        }
+
+        Log.d("Appwrite", result.toString());
+    })
+);
+
+```

examples/1.9.x/client-android/kotlin/presences/delete.md

@@ -0,0 +1,15 @@
+```kotlin
+import io.appwrite.Client
+import io.appwrite.coroutines.CoroutineCallback
+import io.appwrite.services.Presences
+
+val client = Client(context)
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>") // Your project ID
+
+val presences = Presences(client)
+
+val result = presences.delete(
+    presenceId = "<PRESENCE_ID>", 
+)
+```

examples/1.9.x/client-android/kotlin/presences/get.md

@@ -0,0 +1,15 @@
+```kotlin
+import io.appwrite.Client
+import io.appwrite.coroutines.CoroutineCallback
+import io.appwrite.services.Presences
+
+val client = Client(context)
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>") // Your project ID
+
+val presences = Presences(client)
+
+val result = presences.get(
+    presenceId = "<PRESENCE_ID>", 
+)
+```

examples/1.9.x/client-android/kotlin/presences/list.md

@@ -0,0 +1,17 @@
+```kotlin
+import io.appwrite.Client
+import io.appwrite.coroutines.CoroutineCallback
+import io.appwrite.services.Presences
+
+val client = Client(context)
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>") // Your project ID
+
+val presences = Presences(client)
+
+val result = presences.list(
+    queries = listOf(), // (optional)
+    total = false, // (optional)
+    ttl = 0, // (optional)
+)
+```

examples/1.9.x/client-android/kotlin/presences/update.md

@@ -0,0 +1,22 @@
+```kotlin
+import io.appwrite.Client
+import io.appwrite.coroutines.CoroutineCallback
+import io.appwrite.services.Presences
+import io.appwrite.Permission
+import io.appwrite.Role
+
+val client = Client(context)
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>") // Your project ID
+
+val presences = Presences(client)
+
+val result = presences.update(
+    presenceId = "<PRESENCE_ID>", 
+    status = "<STATUS>", // (optional)
+    expiresAt = "2020-10-15T06:38:00.000+00:00", // (optional)
+    metadata = mapOf( "a" to "b" ), // (optional)
+    permissions = listOf(Permission.read(Role.any())), // (optional)
+    purge = false, // (optional)
+)
+```

examples/1.9.x/client-android/kotlin/presences/upsert.md

@@ -0,0 +1,21 @@
+```kotlin
+import io.appwrite.Client
+import io.appwrite.coroutines.CoroutineCallback
+import io.appwrite.services.Presences
+import io.appwrite.Permission
+import io.appwrite.Role
+
+val client = Client(context)
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>") // Your project ID
+
+val presences = Presences(client)
+
+val result = presences.upsert(
+    presenceId = "<PRESENCE_ID>", 
+    status = "<STATUS>", 
+    permissions = listOf(Permission.read(Role.any())), // (optional)
+    expiresAt = "2020-10-15T06:38:00.000+00:00", // (optional)
+    metadata = mapOf( "a" to "b" ), // (optional)
+)
+```

examples/1.9.x/client-apple/examples/avatars/get-screenshot.md

@@ -21,7 +21,7 @@ let bytes = try await avatars.getScreenshot(
     userAgent: "Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X) AppleWebKit/605.1.15", // optional
     fullpage: true, // optional
     locale: "en-US", // optional
-    timezone: .americaNewYork, // optional
+    timezone: .africaAbidjan, // optional
     latitude: 37.7749, // optional
     longitude: -122.4194, // optional
     accuracy: 100, // optional

examples/1.9.x/client-apple/examples/presences/delete.md

@@ -0,0 +1,14 @@
+```swift
+import Appwrite
+
+let client = Client()
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>") // Your project ID
+
+let presences = Presences(client)
+
+let result = try await presences.delete(
+    presenceId: "<PRESENCE_ID>"
+)
+
+```

examples/1.9.x/client-apple/examples/presences/get.md

@@ -0,0 +1,14 @@
+```swift
+import Appwrite
+
+let client = Client()
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>") // Your project ID
+
+let presences = Presences(client)
+
+let presence = try await presences.get(
+    presenceId: "<PRESENCE_ID>"
+)
+
+```

examples/1.9.x/client-apple/examples/presences/list.md

@@ -0,0 +1,16 @@
+```swift
+import Appwrite
+
+let client = Client()
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>") // Your project ID
+
+let presences = Presences(client)
+
+let presenceList = try await presences.list(
+    queries: [], // optional
+    total: false, // optional
+    ttl: 0 // optional
+)
+
+```

examples/1.9.x/client-apple/examples/presences/update.md

@@ -0,0 +1,19 @@
+```swift
+import Appwrite
+
+let client = Client()
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>") // Your project ID
+
+let presences = Presences(client)
+
+let presence = try await presences.update(
+    presenceId: "<PRESENCE_ID>",
+    status: "<STATUS>", // optional
+    expiresAt: "2020-10-15T06:38:00.000+00:00", // optional
+    metadata: [:], // optional
+    permissions: [Permission.read(Role.any())], // optional
+    purge: false // optional
+)
+
+```

examples/1.9.x/client-apple/examples/presences/upsert.md

@@ -0,0 +1,18 @@
+```swift
+import Appwrite
+
+let client = Client()
+    .setEndpoint("https://<REGION>.cloud.appwrite.io/v1") // Your API Endpoint
+    .setProject("<YOUR_PROJECT_ID>") // Your project ID
+
+let presences = Presences(client)
+
+let presence = try await presences.upsert(
+    presenceId: "<PRESENCE_ID>",
+    status: "<STATUS>",
+    permissions: [Permission.read(Role.any())], // optional
+    expiresAt: "2020-10-15T06:38:00.000+00:00", // optional
+    metadata: [:] // optional
+)
+
+```

examples/1.9.x/client-flutter/examples/avatars/get-screenshot.md

@@ -22,7 +22,7 @@ Uint8List bytes = await avatars.getScreenshot(
     userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X) AppleWebKit/605.1.15', // optional
     fullpage: true, // optional
     locale: 'en-US', // optional
-    timezone: enums.Timezone.americaNewYork, // optional
+    timezone: enums.Timezone.africaAbidjan, // optional
     latitude: 37.7749, // optional
     longitude: -122.4194, // optional
     accuracy: 100, // optional
@@ -53,7 +53,7 @@ FutureBuilder(
     userAgent:'Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X) AppleWebKit/605.1.15' , // optional
     fullpage:true , // optional
     locale:'en-US' , // optional
-    timezone: enums.Timezone.americaNewYork, // optional
+    timezone: enums.Timezone.africaAbidjan, // optional
     latitude:37.7749 , // optional
     longitude:-122.4194 , // optional
     accuracy:100 , // optional

examples/1.9.x/client-flutter/examples/presences/delete.md

@@ -0,0 +1,13 @@
+```dart
+import 'package:appwrite/appwrite.dart';
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+Presences presences = Presences(client);
+
+await presences.delete(
+    presenceId: '<PRESENCE_ID>',
+);
+```

examples/1.9.x/client-flutter/examples/presences/get.md

@@ -0,0 +1,13 @@
+```dart
+import 'package:appwrite/appwrite.dart';
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+Presences presences = Presences(client);
+
+Presence result = await presences.get(
+    presenceId: '<PRESENCE_ID>',
+);
+```

examples/1.9.x/client-flutter/examples/presences/list.md

@@ -0,0 +1,15 @@
+```dart
+import 'package:appwrite/appwrite.dart';
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+Presences presences = Presences(client);
+
+PresenceList result = await presences.list(
+    queries: [], // optional
+    total: false, // optional
+    ttl: 0, // optional
+);
+```