Merge pull request #318 from appwrite/dev

feat: Flutter SDK update for version 25.0.0

Author: ArnabChatterjee20k

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Change Log
 
+## 25.0.0
+
+* Breaking: `avatars.getScreenshot` `theme` parameter now uses the `BrowserTheme` enum
+* Breaking: Removed generic type parameters from `presences` service methods
+* Added: `BrowserTheme` enum
+* Updated: `Presence` model is now concrete and adds a `metadata` field
+
 ## 24.1.1
 
 * Fixed: Removed `Advisor` service and `Insight`, `InsightCTA`, `InsightList`, `Report`, `ReportList` models (admin-only endpoints, not intended for client SDKs)

README.md

@@ -19,7 +19,7 @@ Add this to your package's `pubspec.yaml` file:
 
 ```yml
 dependencies:
-  appwrite: ^24.2.0
+  appwrite: ^25.0.0
 ```
 
 You can install packages from the command line:

docs/examples/avatars/get-screenshot.md

@@ -18,11 +18,11 @@ Uint8List bytes = await avatars.getScreenshot(
     viewportWidth: 1920, // optional
     viewportHeight: 1080, // optional
     scale: 2, // optional
-    theme: enums.Theme.dark, // optional
+    theme: enums.BrowserTheme.dark, // optional
     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
@@ -49,11 +49,11 @@ FutureBuilder(
     viewportWidth:1920 , // optional
     viewportHeight:1080 , // optional
     scale:2 , // optional
-    theme: enums.Theme.dark, // optional
+    theme: enums.BrowserTheme.dark, // optional
     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

lib/enums.dart

@@ -7,7 +7,7 @@ part 'src/enums/o_auth_provider.dart';
 part 'src/enums/browser.dart';
 part 'src/enums/credit_card.dart';
 part 'src/enums/flag.dart';
-part 'src/enums/theme.dart';
+part 'src/enums/browser_theme.dart';
 part 'src/enums/timezone.dart';
 part 'src/enums/browser_permission.dart';
 part 'src/enums/image_format.dart';

lib/services/avatars.dart

@@ -205,7 +205,7 @@ class Avatars extends Service {
       int? viewportWidth,
       int? viewportHeight,
       double? scale,
-      enums.Theme? theme,
+      enums.BrowserTheme? theme,
       String? userAgent,
       bool? fullpage,
       String? locale,

lib/src/client_browser.dart

@@ -40,7 +40,7 @@ class ClientBrowser extends ClientBase with ClientMixin {
       'x-sdk-name': 'Flutter',
       'x-sdk-platform': 'client',
       'x-sdk-language': 'flutter',
-      'x-sdk-version': '24.2.0',
+      'x-sdk-version': '25.0.0',
       'X-Appwrite-Response-Format': '1.9.5',
     };
 

lib/src/client_io.dart

@@ -58,7 +58,7 @@ class ClientIO extends ClientBase with ClientMixin {
       'x-sdk-name': 'Flutter',
       'x-sdk-platform': 'client',
       'x-sdk-language': 'flutter',
-      'x-sdk-version': '24.2.0',
+      'x-sdk-version': '25.0.0',
       'X-Appwrite-Response-Format': '1.9.5',
     };
 

lib/src/enums/theme.dart lib/src/enums/browser_theme.dartlib/src/enums/theme.dart renamed to lib/src/enums/browser_theme.dart

@@ -1,10 +1,10 @@
 part of '../../enums.dart';
 
-enum Theme {
+enum BrowserTheme {
   light(value: 'light'),
   dark(value: 'dark');
 
-  const Theme({required this.value});
+  const BrowserTheme({required this.value});
 
   final String value;
 

lib/src/models/document.dart

@@ -45,7 +45,7 @@ class Document implements Model {
       $createdAt: map['\$createdAt'].toString(),
       $updatedAt: map['\$updatedAt'].toString(),
       $permissions: List.from(map['\$permissions'] ?? []),
-      data: Map<String, dynamic>.from(map["data"] ?? {}),
+      data: map["data"] ?? map,
     );
   }
 

lib/src/models/presence.dart

@@ -26,7 +26,8 @@ class Presence implements Model {
   /// Presence expiry date in ISO 8601 format.
   final String? expiresAt;
 
-  final Map<String, dynamic> metadata;
+  /// Presence metadata.
+  final Map<String, dynamic>? metadata;
 
   Presence({
     required this.$id,
@@ -37,7 +38,7 @@ class Presence implements Model {
     this.status,
     required this.source,
     this.expiresAt,
-    required this.metadata,
+    this.metadata,
   });
 
   factory Presence.fromMap(Map<String, dynamic> map) {
@@ -50,7 +51,7 @@ class Presence implements Model {
       status: map['status']?.toString(),
       source: map['source'].toString(),
       expiresAt: map['expiresAt']?.toString(),
-      metadata: Map<String, dynamic>.from(map["metadata"] ?? {}),
+      metadata: map['metadata'],
     );
   }
 
@@ -68,7 +69,4 @@ class Presence implements Model {
       "metadata": metadata,
     };
   }
-
-  T convertTo<T>(T Function(Map<String, dynamic>) fromJson) =>
-      fromJson(metadata);
 }