chore: regenerate sdk

Author: ChiragAgg5k

CHANGELOG.md

@@ -2,7 +2,7 @@
 
 ## 16.0.0
 
-* Add `<REGION>` to doc examples due to the new multi region endpoints
+* Add `<REGION>` to doc examples due to the new multi region endpoints
 * Add doc examples and methods for bulk api transactions: `createDocuments`, `deleteDocuments` etc.
 * Add doc examples, class and methods for new `Sites` service
 * Add doc examples, class and methods for new `Tokens` service
@@ -15,13 +15,13 @@
 ## 14.0.0
 
 * Breaking changes:
-  * Changed the typing of `AppwriteException`&#039;s response parameter from a `dynamic` object to an optional string (`?String`).
+  * Changed the typing of `AppwriteException`'s response parameter from a `dynamic` object to an optional string (`?String`).
 
 ## 13.0.0
 
 * Fixed realtime pong response.
 * Fixed issues with `chunkedUpload` method.
-* Fixed type mismatch bug where `List&lt;dynamic&gt;` was incorrectly causing runtime type errors.
+* Fixed type mismatch bug where `List<dynamic>` was incorrectly causing runtime type errors.
 * Updated return type of `updateMfaChallenge()` from raw data to properly typed `models.Session` object.
 
 ## 12.0.0
@@ -151,7 +151,7 @@ You can find the new syntax for breaking changes in the [Appwrite API references
 * The `number` argument in phone endpoints have been renamed to `phone`
 * List endpoints no longer support `limit`, `offset`, `cursor`, `cursorDirection`, `orderAttributes`, `orderTypes` as they have been moved to the `queries` array
 * `read` and `write` permission have been deprecated and they are now included in the `permissions` array
-* Parameter `permission` for collections and buckets are now renamed to `documentSecurity` &amp; `fileSecurity` respectively
+* Parameter `permission` for collections and buckets are now renamed to `documentSecurity` & `fileSecurity` respectively
 * Renamed methods of the Query helper
     1.  `lesser` renamed to `lessThan`
     2.  `lesserEqual` renamed to `lessThanEqual`
@@ -167,8 +167,8 @@ You can find the new syntax for breaking changes in the [Appwrite API references
 
 ## 6.0.0
 * Support for Appwrite 0.15
-* **BREAKING** `Database` -&gt; `Databases`
-* **BREAKING** `account.createSession()` -&gt; `account.createEmailSession()`
+* **BREAKING** `Database` -> `Databases`
+* **BREAKING** `account.createSession()` -> `account.createEmailSession()`
 * **BREAKING** `dateCreated` attribute removed from `Team`, `Execution`, `File` models
 * **BREAKING** `dateCreated` and `dateUpdated` attribute removed from `Func`, `Deployment`, `Bucket` models
 * **BREAKING** Realtime channels
@@ -182,7 +182,7 @@ You can find the new syntax for breaking changes in the [Appwrite API references
 
 ## 5.0.0
 * Support for Appwrite 0.14
-* **BREAKING** `account.delete()` -&gt; `account.updateStatus()`
+* **BREAKING** `account.delete()` -> `account.updateStatus()`
 * **BREAKING** Execution model `stdout` renamed to `response`
 * **BREAKING** Membership model `name` renamed to `userName` and `email` renamed to `userEmail`
 * Added `teamName` to Membership model
@@ -200,7 +200,7 @@ You can find the new syntax for breaking changes in the [Appwrite API references
 * **BREAKING** **Tags** have been renamed to **Deployments**
 * **BREAKING** `createFile` function expects Bucket ID as the first parameter
 * **BREAKING** `createDeployment` and `createFile` functions expect an instance **InputFile** rather than the instance of **MultipartFile**
-* **BREAKING** `list&lt;Entity&gt;` endpoints now contain a `total` attribute instead of `sum`
+* **BREAKING** `list<Entity>` endpoints now contain a `total` attribute instead of `sum`
 * `onProgress()` callback function for endpoints supporting file uploads
 * Support for synchronous function executions
 * Bug fixes and Improvements
@@ -237,7 +237,7 @@ You can find the new syntax for breaking changes in the [Appwrite API references
 
 ## 0.7.0
 - Support for Appwrite 0.9
-- Breaking - removed order type enum, now you should pass string &#039;ASC&#039; or &#039;DESC&#039;
+- Breaking - removed order type enum, now you should pass string 'ASC' or 'DESC'
 - Breaking - changed param name from `env` to `runtime` in the **Functions** API
 - Image Crop Gravity support in image preview service
 - New endpoint in Account getSession to get session by ID
@@ -258,7 +258,7 @@ You can find the new syntax for breaking changes in the [Appwrite API references
 - Upgraded all underlying dependencies to null safe version
 - BREAKING Renamed users.deleteUser to users.delete
 - BREAKING Renamed parameter inviteId to membershipId on teams.updateMembershipStatus, teams.deleteMembership
-- JWT Support client.setJWT(&#039;JWT_GENERATED_IN_CLIENT&#039;)
+- JWT Support client.setJWT('JWT_GENERATED_IN_CLIENT')
 - [Update membership roles](https://appwrite.io/docs/references/cloud/server-dart/teams?sdk=dart#updateMembershipRoles)
 - New awesome image preview features, supports borderRadius, borderColor, borderWidth
 

README.md

@@ -23,7 +23,7 @@ Add this to your package's `pubspec.yaml` file:
 
 ```yml
 dependencies:
-  dart_appwrite: ^16.0.0
+  dart_appwrite: ^16.0.1
 ```
 
 You can install packages from the command line:

docs/examples/databases/upsert-document.md

@@ -0,0 +1,16 @@
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setSession(''); // The user session to authenticate with
+
+Databases databases = Databases(client);
+
+Document result = await databases.upsertDocument(
+    databaseId: '<DATABASE_ID>',
+    collectionId: '<COLLECTION_ID>',
+    documentId: '<DOCUMENT_ID>',
+    data: {},
+    permissions: ["read("any")"], // (optional)
+);

docs/examples/databases/upsert-documents.md

@@ -10,5 +10,5 @@ Databases databases = Databases(client);
 DocumentList result = await databases.upsertDocuments(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    documents: [], // (optional)
+    documents: [],
 );

lib/client_browser.dart

@@ -1 +1 @@
-export 'src/client_browser.dart';
+export 'src/client_browser.dart';

lib/client_io.dart

@@ -1 +1 @@
-export 'src/client_io.dart';
+export 'src/client_io.dart';

lib/dart_appwrite.dart

@@ -1,6 +1,6 @@
 /// Appwrite Dart SDK
 ///
-/// This SDK is compatible with Appwrite server version 1.7.x.
+/// This SDK is compatible with Appwrite server version 1.7.x. 
 /// For older versions, please check
 /// [previous releases](https://github.com/appwrite/sdk-for-dart/releases).
 library dart_appwrite;

lib/id.dart

@@ -10,7 +10,8 @@ class ID {
     final now = DateTime.now();
     final sec = (now.millisecondsSinceEpoch / 1000).floor();
     final usec = now.microsecondsSinceEpoch - (sec * 1000000);
-    return sec.toRadixString(16) + usec.toRadixString(16).padLeft(5, '0');
+    return sec.toRadixString(16) +
+        usec.toRadixString(16).padLeft(5, '0');
   }
 
   // Generate a unique ID with padding to have a longer ID

lib/query.dart

@@ -1,5 +1,6 @@
 part of 'dart_appwrite.dart';
 
+
 /// Helper class to generate query strings.
 class Query {
   final String method;
@@ -9,13 +10,15 @@ class Query {
   Query._(this.method, [this.attribute = null, this.values = null]);
 
   Map<String, dynamic> toJson() {
-    final map = <String, dynamic>{'method': method};
+    final map = <String, dynamic>{
+      'method': method,
+    };
 
-    if (attribute != null) {
+    if(attribute != null) {
       map['attribute'] = attribute;
     }
-
-    if (values != null) {
+    
+    if(values != null) {
       map['values'] = values is List ? values : [values];
     }
 
@@ -26,7 +29,7 @@ class Query {
   String toString() => jsonEncode(toJson());
 
   /// Filter resources where [attribute] is equal to [value].
-  ///
+  /// 
   /// [value] can be a single value or a list. If a list is used
   /// the query will return resources where [attribute] is equal
   /// to any of the values in the list.
@@ -58,12 +61,10 @@ class Query {
       Query._('search', attribute, value).toString();
 
   /// Filter resources where [attribute] is null.
-  static String isNull(String attribute) =>
-      Query._('isNull', attribute).toString();
+  static String isNull(String attribute) => Query._('isNull', attribute).toString();
 
   /// Filter resources where [attribute] is not null.
-  static String isNotNull(String attribute) =>
-      Query._('isNotNull', attribute).toString();
+  static String isNotNull(String attribute) => Query._('isNotNull', attribute).toString();
 
   /// Filter resources where [attribute] is between [start] and [end] (inclusive).
   static String between(String attribute, dynamic start, dynamic end) =>
@@ -83,52 +84,40 @@ class Query {
       Query._('contains', attribute, value).toString();
 
   static String or(List<String> queries) =>
-      Query._(
-        'or',
-        null,
-        queries.map((query) => jsonDecode(query)).toList(),
-      ).toString();
+    Query._('or', null, queries.map((query) => jsonDecode(query)).toList()).toString();
 
   static String and(List<String> queries) =>
-      Query._(
-        'and',
-        null,
-        queries.map((query) => jsonDecode(query)).toList(),
-      ).toString();
+      Query._('and', null, queries.map((query) => jsonDecode(query)).toList()).toString();
 
   /// Specify which attributes should be returned by the API call.
   static String select(List<String> attributes) =>
       Query._('select', null, attributes).toString();
 
   /// Sort results by [attribute] ascending.
-  static String orderAsc(String attribute) =>
-      Query._('orderAsc', attribute).toString();
+  static String orderAsc(String attribute) => Query._('orderAsc', attribute).toString();
 
   /// Sort results by [attribute] descending.
-  static String orderDesc(String attribute) =>
-      Query._('orderDesc', attribute).toString();
+  static String orderDesc(String attribute) => Query._('orderDesc', attribute).toString();
 
   /// Return results before [id].
-  ///
+  /// 
   /// Refer to the [Cursor Based Pagination](https://appwrite.io/docs/pagination#cursor-pagination)
   /// docs for more information.
-  static String cursorBefore(String id) =>
-      Query._('cursorBefore', null, id).toString();
+  static String cursorBefore(String id) => Query._('cursorBefore', null, id).toString();
 
   /// Return results after [id].
-  ///
+  /// 
   /// Refer to the [Cursor Based Pagination](https://appwrite.io/docs/pagination#cursor-pagination)
   /// docs for more information.
-  static String cursorAfter(String id) =>
-      Query._('cursorAfter', null, id).toString();
+  static String cursorAfter(String id) => Query._('cursorAfter', null, id).toString();
 
   /// Return only [limit] results.
   static String limit(int limit) => Query._('limit', null, limit).toString();
 
   /// Return results from [offset].
-  ///
+  /// 
   /// Refer to the [Offset Pagination](https://appwrite.io/docs/pagination#offset-pagination)
   /// docs for more information.
-  static String offset(int offset) =>
-      Query._('offset', null, offset).toString();
-}
+  static String offset(int offset) => Query._('offset', null, offset).toString();
+
+}

lib/role.dart

@@ -2,65 +2,65 @@ part of 'dart_appwrite.dart';
 
 /// Helper class to generate role strings for [Permission].
 class Role {
-  Role._();
-
-  /// Grants access to anyone.
-  ///
-  /// This includes authenticated and unauthenticated users.
-  static String any() {
-    return 'any';
-  }
+    Role._();
+    
+    /// Grants access to anyone.
+    /// 
+    /// This includes authenticated and unauthenticated users.
+    static String any() {
+        return 'any';
+    }
 
-  /// Grants access to a specific user by user ID.
-  ///
-  /// You can optionally pass verified or unverified for
-  /// [status] to target specific types of users.
-  static String user(String id, [String status = '']) {
-    if (status.isEmpty) {
-      return 'user:$id';
+    /// Grants access to a specific user by user ID.
+    /// 
+    /// You can optionally pass verified or unverified for
+    /// [status] to target specific types of users.
+    static String user(String id, [String status = '']) {
+        if(status.isEmpty) {
+            return 'user:$id';
+        }
+        return 'user:$id/$status';
     }
-    return 'user:$id/$status';
-  }
 
-  /// Grants access to any authenticated or anonymous user.
-  ///
-  /// You can optionally pass verified or unverified for
-  /// [status] to target specific types of users.
-  static String users([String status = '']) {
-    if (status.isEmpty) {
-      return 'users';
+    /// Grants access to any authenticated or anonymous user.
+    /// 
+    /// You can optionally pass verified or unverified for
+    /// [status] to target specific types of users.
+    static String users([String status = '']) {
+        if(status.isEmpty) {
+            return 'users';
+        }
+        return 'users/$status';
     }
-    return 'users/$status';
-  }
 
-  /// Grants access to any guest user without a session.
-  ///
-  /// Authenticated users don't have access to this role.
-  static String guests() {
-    return 'guests';
-  }
+    /// Grants access to any guest user without a session.
+    /// 
+    /// Authenticated users don't have access to this role.
+    static String guests() {
+        return 'guests';
+    }
 
-  /// Grants access to a team by team ID.
-  ///
-  /// You can optionally pass a role for [role] to target
-  /// team members with the specified role.
-  static String team(String id, [String role = '']) {
-    if (role.isEmpty) {
-      return 'team:$id';
+    /// Grants access to a team by team ID.
+    /// 
+    /// You can optionally pass a role for [role] to target
+    /// team members with the specified role.
+    static String team(String id, [String role = '']) {
+        if(role.isEmpty) {
+            return 'team:$id';
+        }
+        return 'team:$id/$role';
     }
-    return 'team:$id/$role';
-  }
 
-  /// Grants access to a specific member of a team.
-  ///
-  /// When the member is removed from the team, they will
-  /// no longer have access.
-  static String member(String id) {
-    return 'member:$id';
-  }
+    /// Grants access to a specific member of a team.
+    /// 
+    /// When the member is removed from the team, they will
+    /// no longer have access.
+    static String member(String id) {
+        return 'member:$id';
+    }
 
-  /// Grants access to a user with the specified label.
-  static String label(String name) {
-    return 'label:$name';
-  }
-}
+    /// Grants access to a user with the specified label.
+    static String label(String name) {
+        return 'label:$name';
+    }
+}