feat: support for 0.14.x

Author: TorstenDittmann

README.md

@@ -2,12 +2,12 @@
 
 [![pub package](https://img.shields.io/pub/v/appwrite?style=flat-square)](https://pub.dartlang.org/packages/appwrite)
 ![License](https://img.shields.io/github/license/appwrite/sdk-for-flutter.svg?style=flat-square)
-![Version](https://img.shields.io/badge/api%20version-0.13.0-blue.svg?style=flat-square)
+![Version](https://img.shields.io/badge/api%20version-0.14.0-blue.svg?style=flat-square)
 [![Build Status](https://img.shields.io/travis/com/appwrite/sdk-generator?style=flat-square)](https://travis-ci.com/appwrite/sdk-generator)
 [![Twitter Account](https://img.shields.io/twitter/follow/appwrite?color=00acee&label=twitter&style=flat-square)](https://twitter.com/appwrite)
 [![Discord](https://img.shields.io/discord/564160730845151244?label=discord&style=flat-square)](https://appwrite.io/discord)
 
-**This SDK is compatible with Appwrite server version 0.13.x. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-flutter/releases).**
+**This SDK is compatible with Appwrite server version 0.14.x. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-flutter/releases).**
 
 Appwrite is an open-source backend as a service server that abstract and simplify complex and repetitive development tasks behind a very simple to use REST API. Appwrite aims to help you develop your apps faster and in a more secure way. Use the Flutter SDK to integrate your app with the Appwrite server to easily start interacting with all of Appwrite backend APIs and tools. For full API documentation and tutorials go to [https://appwrite.io/docs](https://appwrite.io/docs)
 
@@ -21,7 +21,7 @@ Add this to your package's `pubspec.yaml` file:
 
 ```yml
 dependencies:
-  appwrite: ^4.0.2
+  appwrite: ^5.0.0
 ```
 
 You can install packages from the command line:

docs/examples/account/delete.md renamed to docs/examples/account/update-status.md

@@ -8,7 +8,7 @@ void main() { // Init SDK
     .setEndpoint('https://[HOSTNAME_OR_IP]/v1') // Your API Endpoint
     .setProject('5df5acd0d48c2') // Your project ID
   ;
-  Future result = account.delete();
+  Future result = account.updateStatus();
 
   result
     .then((response) {

lib/services/account.dart

@@ -50,28 +50,6 @@ class Account extends Service {
         return models.User.fromMap(res.data);
     }
 
-     /// Delete Account
-     ///
-     /// Delete a currently logged in user account. Behind the scene, the user
-     /// record is not deleted but permanently blocked from any access. This is done
-     /// to avoid deleted accounts being overtaken by new users with the same email
-     /// address. Any user-related resources like documents or storage files should
-     /// be deleted separately.
-     ///
-     Future delete() async {
-        const String path = '/account';
-
-        final Map<String, dynamic> params = {
-        };
-
-        final Map<String, String> headers = {
-            'content-type': 'application/json',
-        };
-
-        final res = await client.call(HttpMethod.delete, path: path, params: params, headers: headers);
-        return  res.data;
-    }
-
      /// Update Account Email
      ///
      /// Update currently logged in user account email address. After changing user
@@ -165,7 +143,7 @@ class Account extends Service {
      ///
      /// Update currently logged in user password. For validation, user is required
      /// to pass in the new password, and the old password. For users created with
-     /// OAuth and Team Invites, oldPassword is optional.
+     /// OAuth, Team Invites and Magic URL, oldPassword is optional.
      ///
      Future<models.User> updatePassword({required String password, String? oldPassword}) async {
         const String path = '/account/password';
@@ -491,6 +469,11 @@ class Account extends Service {
     }
 
      /// Update Session (Refresh Tokens)
+     ///
+     /// Access tokens have limited lifespan and expire to mitigate security risks.
+     /// If session was created using an OAuth provider, this route can be used to
+     /// "refresh" the access token.
+     ///
      Future<models.Session> updateSession({required String sessionId}) async {
         final String path = '/account/sessions/{sessionId}'.replaceAll('{sessionId}', sessionId);
 
@@ -526,6 +509,26 @@ class Account extends Service {
         return  res.data;
     }
 
+     /// Update Account Status
+     ///
+     /// Block the currently logged in user account. Behind the scene, the user
+     /// record is not deleted but permanently blocked from any access. To
+     /// completely delete a user, use the Users API instead.
+     ///
+     Future<models.User> updateStatus() async {
+        const String path = '/account/status';
+
+        final Map<String, dynamic> params = {
+        };
+
+        final Map<String, String> headers = {
+            'content-type': 'application/json',
+        };
+
+        final res = await client.call(HttpMethod.patch, path: path, params: params, headers: headers);
+        return models.User.fromMap(res.data);
+    }
+
      /// Create Email Verification
      ///
      /// Use this endpoint to send a verification message to your user email address

lib/services/avatars.dart

@@ -9,9 +9,14 @@ class Avatars extends Service {
      /// Get Browser Icon
      ///
      /// You can use this endpoint to show different browser icons to your users.
-     /// The code argument receives the browser code as it appears in your user
-     /// /account/sessions endpoint. Use width, height and quality arguments to
-     /// change the output settings.
+     /// The code argument receives the browser code as it appears in your user [GET
+     /// /account/sessions](/docs/client/account#accountGetSessions) endpoint. Use
+     /// width, height and quality arguments to change the output settings.
+     /// 
+     /// When one dimension is specified and the other is 0, the image is scaled
+     /// with preserved aspect ratio. If both dimensions are 0, the API provides an
+     /// image at source quality. If dimensions are not specified, the default size
+     /// of image returned is 100x100px.
      ///
      Future<Uint8List>  getBrowser({required String code, int? width, int? height, int? quality}) async {
         final String path = '/avatars/browsers/{code}'.replaceAll('{code}', code);
@@ -32,6 +37,12 @@ class Avatars extends Service {
      /// The credit card endpoint will return you the icon of the credit card
      /// provider you need. Use width, height and quality arguments to change the
      /// output settings.
+     /// 
+     /// When one dimension is specified and the other is 0, the image is scaled
+     /// with preserved aspect ratio. If both dimensions are 0, the API provides an
+     /// image at source quality. If dimensions are not specified, the default size
+     /// of image returned is 100x100px.
+     /// 
      ///
      Future<Uint8List>  getCreditCard({required String code, int? width, int? height, int? quality}) async {
         final String path = '/avatars/credit-cards/{code}'.replaceAll('{code}', code);
@@ -70,6 +81,12 @@ class Avatars extends Service {
      /// You can use this endpoint to show different country flags icons to your
      /// users. The code argument receives the 2 letter country code. Use width,
      /// height and quality arguments to change the output settings.
+     /// 
+     /// When one dimension is specified and the other is 0, the image is scaled
+     /// with preserved aspect ratio. If both dimensions are 0, the API provides an
+     /// image at source quality. If dimensions are not specified, the default size
+     /// of image returned is 100x100px.
+     /// 
      ///
      Future<Uint8List>  getFlag({required String code, int? width, int? height, int? quality}) async {
         final String path = '/avatars/flags/{code}'.replaceAll('{code}', code);
@@ -91,6 +108,12 @@ class Avatars extends Service {
      /// you want. This endpoint is very useful if you need to crop and display
      /// remote images in your app or in case you want to make sure a 3rd party
      /// image is properly served using a TLS protocol.
+     /// 
+     /// When one dimension is specified and the other is 0, the image is scaled
+     /// with preserved aspect ratio. If both dimensions are 0, the API provides an
+     /// image at source quality. If dimensions are not specified, the default size
+     /// of image returned is 400x400px.
+     /// 
      ///
      Future<Uint8List>  getImage({required String url, int? width, int? height}) async {
         const String path = '/avatars/image';
@@ -118,6 +141,12 @@ class Avatars extends Service {
      /// default, a random theme will be selected. The random theme will persist for
      /// the user's initials when reloading the same theme will always return for
      /// the same initials.
+     /// 
+     /// When one dimension is specified and the other is 0, the image is scaled
+     /// with preserved aspect ratio. If both dimensions are 0, the API provides an
+     /// image at source quality. If dimensions are not specified, the default size
+     /// of image returned is 100x100px.
+     /// 
      ///
      Future<Uint8List>  getInitials({String? name, int? width, int? height, String? color, String? background}) async {
         const String path = '/avatars/initials';
@@ -139,6 +168,7 @@ class Avatars extends Service {
      ///
      /// Converts a given plain text to a QR code image. You can use the query
      /// parameters to change the size and style of the resulting image.
+     /// 
      ///
      Future<Uint8List>  getQR({required String text, int? size, int? margin, bool? download}) async {
         const String path = '/avatars/qr';

lib/services/database.dart

@@ -102,9 +102,7 @@ class Database extends Service {
 
      /// Delete Document
      ///
-     /// Delete a document by its unique ID. This endpoint deletes only the parent
-     /// documents, its attributes and relations to other documents. Child documents
-     /// **will not** be deleted.
+     /// Delete a document by its unique ID.
      ///
      Future deleteDocument({required String collectionId, required String documentId}) async {
         final String path = '/database/collections/{collectionId}/documents/{documentId}'.replaceAll('{collectionId}', collectionId).replaceAll('{documentId}', documentId);

lib/src/client_browser.dart

@@ -37,7 +37,7 @@ class ClientBrowser extends ClientBase with ClientMixin {
         .replaceFirst('http://', 'ws://');
     _headers = {
       'content-type': 'application/json',
-      'x-sdk-version': 'appwrite:flutter:4.0.2',
+      'x-sdk-version': 'appwrite:flutter:5.0.0',
       'X-Appwrite-Response-Format' : '0.13.0',
     };
 

lib/src/client_io.dart

@@ -55,7 +55,7 @@ class ClientIO extends ClientBase with ClientMixin {
         .replaceFirst('http://', 'ws://');
     _headers = {
       'content-type': 'application/json',
-      'x-sdk-version': 'appwrite:flutter:4.0.2',
+      'x-sdk-version': 'appwrite:flutter:5.0.0',
       'X-Appwrite-Response-Format' : '0.13.0',
     };
 

lib/src/models/execution.dart

@@ -16,8 +16,8 @@ class Execution implements Model {
     final String status;
     /// The script status code.
     final int statusCode;
-    /// The script stdout output string. Logs the last 4,000 characters of the execution stdout output.
-    final String stdout;
+    /// The script response output string. Logs the last 4,000 characters of the execution response output.
+    final String response;
     /// The script stderr output string. Logs the last 4,000 characters of the execution stderr output
     final String stderr;
     /// The script execution time in seconds.
@@ -31,7 +31,7 @@ class Execution implements Model {
         required this.trigger,
         required this.status,
         required this.statusCode,
-        required this.stdout,
+        required this.response,
         required this.stderr,
         required this.time,
     });
@@ -45,7 +45,7 @@ class Execution implements Model {
             trigger: map['trigger'].toString(),
             status: map['status'].toString(),
             statusCode: map['statusCode'],
-            stdout: map['stdout'].toString(),
+            response: map['response'].toString(),
             stderr: map['stderr'].toString(),
             time: map['time'].toDouble(),
         );
@@ -61,7 +61,7 @@ class Execution implements Model {
             "trigger": trigger,
             "status": status,
             "statusCode": statusCode,
-            "stdout": stdout,
+            "response": response,
             "stderr": stderr,
             "time": time,
         };

lib/src/models/membership.dart

@@ -6,12 +6,14 @@ class Membership implements Model {
     final String $id;
     /// User ID.
     final String userId;
-    /// Team ID.
-    final String teamId;
     /// User name.
-    final String name;
+    final String userName;
     /// User email address.
-    final String email;
+    final String userEmail;
+    /// Team ID.
+    final String teamId;
+    /// Team name.
+    final String teamName;
     /// Date, the user has been invited to join the team in Unix timestamp.
     final int invited;
     /// Date, the user has accepted the invitation to join the team in Unix timestamp.
@@ -24,9 +26,10 @@ class Membership implements Model {
     Membership({
         required this.$id,
         required this.userId,
+        required this.userName,
+        required this.userEmail,
         required this.teamId,
-        required this.name,
-        required this.email,
+        required this.teamName,
         required this.invited,
         required this.joined,
         required this.confirm,
@@ -37,9 +40,10 @@ class Membership implements Model {
         return Membership(
             $id: map['\$id'].toString(),
             userId: map['userId'].toString(),
+            userName: map['userName'].toString(),
+            userEmail: map['userEmail'].toString(),
             teamId: map['teamId'].toString(),
-            name: map['name'].toString(),
-            email: map['email'].toString(),
+            teamName: map['teamName'].toString(),
             invited: map['invited'],
             joined: map['joined'],
             confirm: map['confirm'],
@@ -52,9 +56,10 @@ class Membership implements Model {
         return {
             "\$id": $id,
             "userId": userId,
+            "userName": userName,
+            "userEmail": userEmail,
             "teamId": teamId,
-            "name": name,
-            "email": email,
+            "teamName": teamName,
             "invited": invited,
             "joined": joined,
             "confirm": confirm,

pubspec.yaml

@@ -1,5 +1,5 @@
 name: appwrite
-version: 4.0.2
+version: 5.0.0
 description: Appwrite is an open-source self-hosted backend server that abstract and simplify complex and repetitive development tasks behind a very simple REST API
 homepage: https://appwrite.io
 repository: https://github.com/appwrite/sdk-for-flutter