chore: add changelog

Author: ChiragAgg5k

CHANGELOG.md

@@ -1,3 +1,17 @@
+# Change Log
+
+## 16.0.0
+
+* 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
+* Add enums for `BuildRuntime `, `Adapter`, `Framework`, `DeploymentDownloadType` and `VCSDeploymentType`
+* Add `token` param to `getFilePreview` and `getFileView` for File tokens usage
+* Add `queries` and `search` params to `listMemberships` method
+* Update enum for `runtimes` with Pythonml312, Dart219, Flutter327 and Flutter329
+* Remove `search` param from `listExecutions` method
+
 ## 14.0.0
 
 * Breaking changes:

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';
+    }
+}