Upgraded to support Appwrite 0.8

Author: eldadfux

CHANGELOG.md

@@ -1,3 +1,15 @@
+## 0.6.0
+
+- Upgraded to Null-safety, minimum Dart SDK required 2.12.0
+- Upgraded all underlying dependencies to null safe version
+- BREAKING Renamed parameter inviteId to membershipId on teams.updateMembershipStatus, teams.deleteMembership
+- [Anonymous login](https://appwrite.io/docs/client/account?sdk=flutter#accountCreateAnonymousSession)
+- [JWT Support](https://appwrite.io/docs/client/account?sdk=flutter#accountCreateJWT)
+- Fallback Cookies for Flutter Web if 3rd party cookies are blocked
+- Custom User Agent Support
+- [Update membership roles](https://appwrite.io/docs/client/teams?sdk=flutter#teamsUpdateMembershipRoles)
+- New awesome image preview features, supports borderRadius, borderColor, borderWidth 
+
 ## 0.5.0-dev.1
 
 - Upgraded to Null-safety, minimum Dart SDK required 2.12.0 and minimum Flutter SDK version required 2.0.0

README.md

@@ -2,11 +2,11 @@
 
 [![pub package](https://img.shields.io/pub/v/appwrite?style=flat-square.svg)](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.7.0-blue.svg?style=flat-square)
+![Version](https://img.shields.io/badge/api%20version-0.8.0-blue.svg?style=flat-square)
 [![Twitter Account](https://img.shields.io/twitter/follow/appwrite_io?color=00acee&label=twitter&style=flat-square)](https://twitter.com/appwrite_io)
 [![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.7.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.8.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.
@@ -22,7 +22,7 @@ Add this to your package's `pubspec.yaml` file:
 
 ```yml
 dependencies:
-  appwrite: ^0.5.0-dev.1
+  appwrite: ^0.6.0
 ```
 
 You can install packages from the command line:
@@ -92,7 +92,7 @@ Client client = Client();
 client
   .setEndpoint('https://localhost/v1') // Your Appwrite Endpoint
   .setProject('5e8cf4f46b5e8') // Your project ID
-  .setSelfSigned() // Remove in production
+  .setSelfSigned() // Use only on dev mode with a self-signed SSL cert
 ;
 ```
 
@@ -125,7 +125,7 @@ Client client = Client();
 client
   .setEndpoint('https://localhost/v1') // Your Appwrite Endpoint
   .setProject('5e8cf4f46b5e8') // Your project ID
-  .setSelfSigned() // Remove in production
+  .setSelfSigned() // Use only on dev mode with a self-signed SSL cert
   ;
 
 
@@ -140,6 +140,21 @@ Response user = await account
   );
 ```
 
+### Error Handling
+The Appwrite Flutter SDK raises `AppwriteException` object with `message`, `code` and `response` properties. You can handle any errors by catching `AppwriteException` and present the `message` to the user or handle it yourself based on the provided error information. Below is an example.
+
+```dart
+Users users = Users(client);
+
+try {
+  final response = await users.create(email: ‘[email protected]’,password: ‘password’, name: ‘name’);
+  print(response.data);
+} on AppwriteException catch(e) {
+  //show message to user or do other operation based on error as required
+  print(e.message);
+}
+```
+
 ### Learn more
 You can use followng resources to learn more and get help
 - 🚀 [Getting Started Tutorial](https://appwrite.io/docs/getting-started-for-flutter)

docs/examples/account/create-anonymous-session.md

@@ -0,0 +1,19 @@
+import 'package:appwrite/appwrite.dart';
+
+void main() { // Init SDK
+  Client client = Client();
+  Account account = Account(client);
+
+  client
+    .setEndpoint('https://[HOSTNAME_OR_IP]/v1') // Your API Endpoint
+    .setProject('5df5acd0d48c2') // Your project ID
+  ;
+  Future result = account.createAnonymousSession();
+
+  result
+    .then((response) {
+      print(response);
+    }).catchError((error) {
+      print(error.response);
+  });
+}

docs/examples/account/create-j-w-t.md

@@ -0,0 +1,19 @@
+import 'package:appwrite/appwrite.dart';
+
+void main() { // Init SDK
+  Client client = Client();
+  Account account = Account(client);
+
+  client
+    .setEndpoint('https://[HOSTNAME_OR_IP]/v1') // Your API Endpoint
+    .setProject('5df5acd0d48c2') // Your project ID
+  ;
+  Future result = account.createJWT();
+
+  result
+    .then((response) {
+      print(response);
+    }).catchError((error) {
+      print(error.response);
+  });
+}

docs/examples/account/create-recovery.md

@@ -7,6 +7,7 @@ void main() { // Init SDK
   client
     .setEndpoint('https://[HOSTNAME_OR_IP]/v1') // Your API Endpoint
     .setProject('5df5acd0d48c2') // Your project ID
+    .setJWT('eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ...') // Your secret JSON Web Token
   ;
   Future result = account.createRecovery(
     email: '[email protected]',

docs/examples/account/create-verification.md

@@ -7,6 +7,7 @@ void main() { // Init SDK
   client
     .setEndpoint('https://[HOSTNAME_OR_IP]/v1') // Your API Endpoint
     .setProject('5df5acd0d48c2') // Your project ID
+    .setJWT('eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ...') // Your secret JSON Web Token
   ;
   Future result = account.createVerification(
     url: 'https://example.com',

docs/examples/account/delete-session.md

@@ -7,6 +7,7 @@ void main() { // Init SDK
   client
     .setEndpoint('https://[HOSTNAME_OR_IP]/v1') // Your API Endpoint
     .setProject('5df5acd0d48c2') // Your project ID
+    .setJWT('eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ...') // Your secret JSON Web Token
   ;
   Future result = account.deleteSession(
     sessionId: '[SESSION_ID]',

docs/examples/account/delete-sessions.md

@@ -7,6 +7,7 @@ void main() { // Init SDK
   client
     .setEndpoint('https://[HOSTNAME_OR_IP]/v1') // Your API Endpoint
     .setProject('5df5acd0d48c2') // Your project ID
+    .setJWT('eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ...') // Your secret JSON Web Token
   ;
   Future result = account.deleteSessions();
 

docs/examples/account/delete.md

@@ -7,6 +7,7 @@ void main() { // Init SDK
   client
     .setEndpoint('https://[HOSTNAME_OR_IP]/v1') // Your API Endpoint
     .setProject('5df5acd0d48c2') // Your project ID
+    .setJWT('eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ...') // Your secret JSON Web Token
   ;
   Future result = account.delete();
 

docs/examples/account/get-logs.md

@@ -7,6 +7,7 @@ void main() { // Init SDK
   client
     .setEndpoint('https://[HOSTNAME_OR_IP]/v1') // Your API Endpoint
     .setProject('5df5acd0d48c2') // Your project ID
+    .setJWT('eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ...') // Your secret JSON Web Token
   ;
   Future result = account.getLogs();