Merge pull request #273 from appwrite/dev

feat: Flutter SDK update for version 19.1.0

Author: abnegate

.github/workflows/format.yml

@@ -10,21 +10,15 @@ on:
 jobs:
   format:
     runs-on: ubuntu-latest
+    container:
+        image:  dart:stable
 
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
         with:
           persist-credentials: true
           ref: ${{ github.event.pull_request.head.ref }}
-      
-      - name: Install Flutter
-        uses: subosito/flutter-action@v2
-        with:
-          channel: stable
-
-      - name: Install dependencies
-        run: flutter pub get
 
       - name: Format Dart code
         run: dart format .
@@ -35,5 +29,5 @@ jobs:
       - name: Add & Commit
         uses: EndBug/add-and-commit@v9.1.4
         with:
-            add: '["lib", "test"]'
+            add: lib
 

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Change Log
 
+## 19.1.0
+
+* Add `orderRandom` query support
+
 ## 19.0.0
 
 * Rename `CreditCard` enum value `unionChinaPay` to `unionPay`

README.md

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

lib/query.dart

@@ -130,16 +130,16 @@ class Query {
       Query._('updatedBetween', null, [start, end]).toString();
 
   static String or(List<String> queries) => Query._(
-        'or',
-        null,
-        queries.map((query) => jsonDecode(query)).toList(),
-      ).toString();
+    '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();
+    '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) =>
@@ -153,6 +153,9 @@ class Query {
   static String orderDesc(String attribute) =>
       Query._('orderDesc', attribute).toString();
 
+  /// Sort results randomly.
+  static String orderRandom() => Query._('orderRandom').toString();
+
   /// Return results before [id].
   ///
   /// Refer to the [Cursor Based Pagination](https://appwrite.io/docs/pagination#cursor-pagination)
@@ -179,35 +182,43 @@ class Query {
 
   /// Filter resources where [attribute] is at a specific distance from the given coordinates.
   static String distanceEqual(
-          String attribute, List<dynamic> values, num distance,
-          [bool meters = true]) =>
-      Query._('distanceEqual', attribute, [
-        [values, distance, meters]
-      ]).toString();
+    String attribute,
+    List<dynamic> values,
+    num distance, [
+    bool meters = true,
+  ]) => Query._('distanceEqual', attribute, [
+    [values, distance, meters],
+  ]).toString();
 
   /// Filter resources where [attribute] is not at a specific distance from the given coordinates.
   static String distanceNotEqual(
-          String attribute, List<dynamic> values, num distance,
-          [bool meters = true]) =>
-      Query._('distanceNotEqual', attribute, [
-        [values, distance, meters]
-      ]).toString();
+    String attribute,
+    List<dynamic> values,
+    num distance, [
+    bool meters = true,
+  ]) => Query._('distanceNotEqual', attribute, [
+    [values, distance, meters],
+  ]).toString();
 
   /// Filter resources where [attribute] is at a distance greater than the specified value from the given coordinates.
   static String distanceGreaterThan(
-          String attribute, List<dynamic> values, num distance,
-          [bool meters = true]) =>
-      Query._('distanceGreaterThan', attribute, [
-        [values, distance, meters]
-      ]).toString();
+    String attribute,
+    List<dynamic> values,
+    num distance, [
+    bool meters = true,
+  ]) => Query._('distanceGreaterThan', attribute, [
+    [values, distance, meters],
+  ]).toString();
 
   /// Filter resources where [attribute] is at a distance less than the specified value from the given coordinates.
   static String distanceLessThan(
-          String attribute, List<dynamic> values, num distance,
-          [bool meters = true]) =>
-      Query._('distanceLessThan', attribute, [
-        [values, distance, meters]
-      ]).toString();
+    String attribute,
+    List<dynamic> values,
+    num distance, [
+    bool meters = true,
+  ]) => Query._('distanceLessThan', attribute, [
+    [values, distance, meters],
+  ]).toString();
 
   /// Filter resources where [attribute] intersects with the given geometry.
   static String intersects(String attribute, List<dynamic> values) =>

lib/services/account.dart

@@ -890,7 +890,9 @@ class Account extends Service {
   /// Use this endpoint to create a session from token. Provide the **userId**
   /// and **secret** parameters from the successful response of authentication
   /// flows initiated by token creation. For example, magic URL and phone login.
-  @Deprecated('This API has been deprecated.')
+  @Deprecated(
+    'This API has been deprecated since 1.6.0. Please use `Account.createSession` instead.',
+  )
   Future<models.Session> updateMagicURLSession({
     required String userId,
     required String secret,
@@ -942,6 +944,7 @@ class Account extends Service {
       'success': success,
       'failure': failure,
       'scopes': scopes,
+
       'project': client.config['project'],
     };
 
@@ -974,7 +977,9 @@ class Account extends Service {
   /// Use this endpoint to create a session from token. Provide the **userId**
   /// and **secret** parameters from the successful response of authentication
   /// flows initiated by token creation. For example, magic URL and phone login.
-  @Deprecated('This API has been deprecated.')
+  @Deprecated(
+    'This API has been deprecated since 1.6.0. Please use `Account.createSession` instead.',
+  )
   Future<models.Session> updatePhoneSession({
     required String userId,
     required String secret,
@@ -1298,6 +1303,7 @@ class Account extends Service {
       'success': success,
       'failure': failure,
       'scopes': scopes,
+
       'project': client.config['project'],
     };
 

lib/services/avatars.dart

@@ -31,6 +31,7 @@ class Avatars extends Service {
       'width': width,
       'height': height,
       'quality': quality,
+
       'project': client.config['project'],
     };
 
@@ -67,6 +68,7 @@ class Avatars extends Service {
       'width': width,
       'height': height,
       'quality': quality,
+
       'project': client.config['project'],
     };
 
@@ -88,6 +90,7 @@ class Avatars extends Service {
 
     final Map<String, dynamic> params = {
       'url': url,
+
       'project': client.config['project'],
     };
 
@@ -125,6 +128,7 @@ class Avatars extends Service {
       'width': width,
       'height': height,
       'quality': quality,
+
       'project': client.config['project'],
     };
 
@@ -159,6 +163,7 @@ class Avatars extends Service {
       'url': url,
       'width': width,
       'height': height,
+
       'project': client.config['project'],
     };
 
@@ -200,6 +205,7 @@ class Avatars extends Service {
       'width': width,
       'height': height,
       'background': background,
+
       'project': client.config['project'],
     };
 
@@ -228,6 +234,7 @@ class Avatars extends Service {
       'size': size,
       'margin': margin,
       'download': download,
+
       'project': client.config['project'],
     };