appwrite · christyjacob4 · Jan 21, 2025 · Dec 10, 2024 · Dec 10, 2024
diff --git a/README.md b/README.md
@@ -23,7 +23,7 @@ Add this to your package's `pubspec.yaml` file:
 
 ```yml
 dependencies:
-  dart_appwrite: ^12.1.0
+  dart_appwrite: ^12.2.0
 ```
 
 You can install packages from the command line:

diff --git a/docs/examples/databases/update-string-attribute.md b/docs/examples/databases/update-string-attribute.md
@@ -13,6 +13,6 @@ AttributeString result = await databases.updateStringAttribute(
     key: '',
     xrequired: false,
     xdefault: '<DEFAULT>',
-    size: 0, // (optional)
+    size: 1, // (optional)
     newKey: '', // (optional)
 );
diff --git a/docs/examples/messaging/create-push.md b/docs/examples/messaging/create-push.md
@@ -9,8 +9,8 @@ Messaging messaging = Messaging(client);
 
 Message result = await messaging.createPush(
     messageId: '<MESSAGE_ID>',
-    title: '<TITLE>',
-    body: '<BODY>',
+    title: '<TITLE>', // (optional)
+    body: '<BODY>', // (optional)
     topics: [], // (optional)
     users: [], // (optional)
     targets: [], // (optional)
@@ -21,7 +21,10 @@ Message result = await messaging.createPush(
     sound: '<SOUND>', // (optional)
     color: '<COLOR>', // (optional)
     tag: '<TAG>', // (optional)
-    badge: '<BADGE>', // (optional)
+    badge: 0, // (optional)
     draft: false, // (optional)
     scheduledAt: '', // (optional)
+    contentAvailable: false, // (optional)
+    critical: false, // (optional)
+    priority: MessagePriority.normal, // (optional)
 );
diff --git a/docs/examples/messaging/update-push.md b/docs/examples/messaging/update-push.md
@@ -24,4 +24,7 @@ Message result = await messaging.updatePush(
     badge: 0, // (optional)
     draft: false, // (optional)
     scheduledAt: '', // (optional)
+    contentAvailable: false, // (optional)
+    critical: false, // (optional)
+    priority: MessagePriority.normal, // (optional)
 );
diff --git a/lib/enums.dart b/lib/enums.dart
@@ -13,6 +13,7 @@ part 'src/enums/index_type.dart';
 part 'src/enums/runtime.dart';
 part 'src/enums/execution_method.dart';
 part 'src/enums/name.dart';
+part 'src/enums/message_priority.dart';
 part 'src/enums/smtp_encryption.dart';
 part 'src/enums/compression.dart';
 part 'src/enums/image_gravity.dart';

diff --git a/lib/services/account.dart b/lib/services/account.dart
@@ -84,7 +84,7 @@ class Account extends Service {
     return models.User.fromMap(res.data);
   }
 
-  /// List Identities
+  /// List identities
   ///
   /// Get the list of identities for the currently logged in user.
   Future<models.IdentityList> listIdentities({List<String>? queries}) async {
@@ -186,7 +186,7 @@ class Account extends Service {
     return models.User.fromMap(res.data);
   }
 
-  /// Create Authenticator
+  /// Create authenticator
   ///
   /// Add an authenticator app to be used as an MFA factor. Verify the
   /// authenticator using the [verify
@@ -209,7 +209,7 @@ class Account extends Service {
     return models.MfaType.fromMap(res.data);
   }
 
-  /// Verify Authenticator
+  /// Verify authenticator
   ///
   /// Verify an authenticator app after adding it using the [add
   /// authenticator](/docs/references/cloud/client-web/account#createMfaAuthenticator)
@@ -233,7 +233,7 @@ class Account extends Service {
     return models.User.fromMap(res.data);
   }
 
-  /// Delete Authenticator
+  /// Delete authenticator
   ///
   /// Delete an authenticator for a user by ID.
   Future deleteMfaAuthenticator({required enums.AuthenticatorType type}) async {
@@ -252,7 +252,7 @@ class Account extends Service {
     return res.data;
   }
 
-  /// Create MFA Challenge
+  /// Create MFA challenge
   ///
   /// Begin the process of MFA verification after sign-in. Finish the flow with
   /// [updateMfaChallenge](/docs/references/cloud/client-web/account#updateMfaChallenge)
@@ -275,7 +275,7 @@ class Account extends Service {
     return models.MfaChallenge.fromMap(res.data);
   }
 
-  /// Create MFA Challenge (confirmation)
+  /// Create MFA challenge (confirmation)
   ///
   /// Complete the MFA challenge by providing the one-time password. Finish the
   /// process of MFA verification by providing the one-time password. To begin
@@ -301,7 +301,7 @@ class Account extends Service {
     return res.data;
   }
 
-  /// List Factors
+  /// List factors
   ///
   /// List the factors available on the account to be used as a MFA challange.
   Future<models.MfaFactors> listMfaFactors() async {
@@ -319,7 +319,7 @@ class Account extends Service {
     return models.MfaFactors.fromMap(res.data);
   }
 
-  /// Get MFA Recovery Codes
+  /// Get MFA recovery codes
   ///
   /// Get recovery codes that can be used as backup for MFA flow. Before getting
   /// codes, they must be generated using
@@ -340,7 +340,7 @@ class Account extends Service {
     return models.MfaRecoveryCodes.fromMap(res.data);
   }
 
-  /// Create MFA Recovery Codes
+  /// Create MFA recovery codes
   ///
   /// Generate recovery codes as backup for MFA flow. It's recommended to
   /// generate and show then immediately after user successfully adds their
@@ -362,7 +362,7 @@ class Account extends Service {
     return models.MfaRecoveryCodes.fromMap(res.data);
   }
 
-  /// Regenerate MFA Recovery Codes
+  /// Regenerate MFA recovery codes
   ///
   /// Regenerate recovery codes that can be used as backup for MFA flow. Before
   /// regenerating codes, they must be first generated using
@@ -843,9 +843,7 @@ class Account extends Service {
   /// [POST
   /// /v1/account/sessions/token](https://appwrite.io/docs/references/cloud/client-web/account#createSession)
   /// endpoint to complete the login process. The link sent to the user's email
-  /// address is valid for 1 hour. If you are on a mobile device you can leave
-  /// the URL parameter empty, so that the login completion will be handled by
-  /// your Appwrite instance by default.
+  /// address is valid for 1 hour.
   ///
   /// A user is limited to 10 active sessions at a time by default. [Learn more
   /// about session

diff --git a/lib/services/locale.dart b/lib/services/locale.dart
@@ -28,7 +28,7 @@ class Locale extends Service {
     return models.Locale.fromMap(res.data);
   }
 
-  /// List Locale Codes
+  /// List locale codes
   ///
   /// List of all locale codes in [ISO
   /// 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes).

diff --git a/lib/services/messaging.dart b/lib/services/messaging.dart
@@ -119,8 +119,8 @@ class Messaging extends Service {
   /// Create a new push notification.
   Future<models.Message> createPush(
       {required String messageId,
-      required String title,
-      required String body,
+      String? title,
+      String? body,
       List<String>? topics,
       List<String>? users,
       List<String>? targets,
@@ -131,9 +131,12 @@ class Messaging extends Service {
       String? sound,
       String? color,
       String? tag,
-      String? badge,
+      int? badge,
       bool? draft,
-      String? scheduledAt}) async {
+      String? scheduledAt,
+      bool? contentAvailable,
+      bool? critical,
+      enums.MessagePriority? priority}) async {
     final String apiPath = '/messaging/messages/push';
 
     final Map<String, dynamic> apiParams = {
@@ -153,6 +156,9 @@ class Messaging extends Service {
       'badge': badge,
       'draft': draft,
       'scheduledAt': scheduledAt,
+      'contentAvailable': contentAvailable,
+      'critical': critical,
+      'priority': priority?.value,
     };
 
     final Map<String, String> apiHeaders = {
@@ -185,7 +191,10 @@ class Messaging extends Service {
       String? tag,
       int? badge,
       bool? draft,
-      String? scheduledAt}) async {
+      String? scheduledAt,
+      bool? contentAvailable,
+      bool? critical,
+      enums.MessagePriority? priority}) async {
     final String apiPath = '/messaging/messages/push/{messageId}'
         .replaceAll('{messageId}', messageId);
 
@@ -205,6 +214,9 @@ class Messaging extends Service {
       'badge': badge,
       'draft': draft,
       'scheduledAt': scheduledAt,
+      'contentAvailable': contentAvailable,
+      'critical': critical,
+      'priority': priority?.value,
     };
 
     final Map<String, String> apiHeaders = {

diff --git a/lib/services/storage.dart b/lib/services/storage.dart
@@ -272,7 +272,7 @@ class Storage extends Service {
     return models.File.fromMap(res.data);
   }
 
-  /// Delete File
+  /// Delete file
   ///
   /// Delete a file by its unique ID. Only users with write permissions have
   /// access to delete this resource.

diff --git a/lib/services/teams.dart b/lib/services/teams.dart
@@ -115,7 +115,8 @@ class Teams extends Service {
   /// List team memberships
   ///
   /// Use this endpoint to list a team's members using the team's ID. All team
-  /// members have read access to this endpoint.
+  /// members have read access to this endpoint. Hide sensitive attributes from
+  /// the response by toggling membership privacy in the Console.
   Future<models.MembershipList> listMemberships(
       {required String teamId, List<String>? queries, String? search}) async {
     final String apiPath =
@@ -192,7 +193,8 @@ class Teams extends Service {
   /// Get team membership
   ///
   /// Get a team member by the membership unique id. All team members have read
-  /// access for this resource.
+  /// access for this resource. Hide sensitive attributes from the response by
+  /// toggling membership privacy in the Console.
   Future<models.Membership> getMembership(
       {required String teamId, required String membershipId}) async {
     final String apiPath = '/teams/{teamId}/memberships/{membershipId}'

diff --git a/lib/services/users.dart b/lib/services/users.dart
@@ -115,7 +115,7 @@ class Users extends Service {
     return models.User.fromMap(res.data);
   }
 
-  /// List Identities
+  /// List identities
   ///
   /// Get identities for all users.
   Future<models.IdentityList> listIdentities(
@@ -503,7 +503,7 @@ class Users extends Service {
     return models.User.fromMap(res.data);
   }
 
-  /// Delete Authenticator
+  /// Delete authenticator
   ///
   /// Delete an authenticator app.
   Future<models.User> deleteMfaAuthenticator(
@@ -524,7 +524,7 @@ class Users extends Service {
     return models.User.fromMap(res.data);
   }
 
-  /// List Factors
+  /// List factors
   ///
   /// List the factors available on the account to be used as a MFA challange.
   Future<models.MfaFactors> listMfaFactors({required String userId}) async {
@@ -543,7 +543,7 @@ class Users extends Service {
     return models.MfaFactors.fromMap(res.data);
   }
 
-  /// Get MFA Recovery Codes
+  /// Get MFA recovery codes
   ///
   /// Get recovery codes that can be used as backup for MFA flow by User ID.
   /// Before getting codes, they must be generated using
@@ -566,7 +566,7 @@ class Users extends Service {
     return models.MfaRecoveryCodes.fromMap(res.data);
   }
 
-  /// Regenerate MFA Recovery Codes
+  /// Regenerate MFA recovery codes
   ///
   /// Regenerate recovery codes that can be used as backup for MFA flow by User
   /// ID. Before regenerating codes, they must be first generated using
@@ -589,7 +589,7 @@ class Users extends Service {
     return models.MfaRecoveryCodes.fromMap(res.data);
   }
 
-  /// Create MFA Recovery Codes
+  /// Create MFA recovery codes
   ///
   /// Generate recovery codes used as backup for MFA flow for User ID. Recovery
   /// codes can be used as a MFA verification type in
@@ -827,7 +827,7 @@ class Users extends Service {
     return models.User.fromMap(res.data);
   }
 
-  /// List User Targets
+  /// List user targets
   ///
   /// List the messaging targets that are associated with a user.
   Future<models.TargetList> listTargets(
@@ -849,7 +849,7 @@ class Users extends Service {
     return models.TargetList.fromMap(res.data);
   }
 
-  /// Create User Target
+  /// Create user target
   ///
   /// Create a messaging target.
   Future<models.Target> createTarget(
@@ -880,7 +880,7 @@ class Users extends Service {
     return models.Target.fromMap(res.data);
   }
 
-  /// Get User Target
+  /// Get user target
   ///
   /// Get a user's push notification target by ID.
   Future<models.Target> getTarget(
@@ -901,7 +901,7 @@ class Users extends Service {
     return models.Target.fromMap(res.data);
   }
 
-  /// Update User target
+  /// Update user target
   ///
   /// Update a messaging target.
   Future<models.Target> updateTarget(

diff --git a/lib/src/client_browser.dart b/lib/src/client_browser.dart
@@ -33,7 +33,7 @@ class ClientBrowser extends ClientBase with ClientMixin {
       'x-sdk-name': 'Dart',
       'x-sdk-platform': 'server',
       'x-sdk-language': 'dart',
-      'x-sdk-version': '12.1.0',
+      'x-sdk-version': '12.2.0',
       'X-Appwrite-Response-Format': '1.6.0',
     };
 

diff --git a/lib/src/client_io.dart b/lib/src/client_io.dart
@@ -42,9 +42,9 @@ class ClientIO extends ClientBase with ClientMixin {
       'x-sdk-name': 'Dart',
       'x-sdk-platform': 'server',
       'x-sdk-language': 'dart',
-      'x-sdk-version': '12.1.0',
+      'x-sdk-version': '12.2.0',
       'user-agent':
-          'AppwriteDartSDK/12.1.0 (${Platform.operatingSystem}; ${Platform.operatingSystemVersion})',
+          'AppwriteDartSDK/12.2.0 (${Platform.operatingSystem}; ${Platform.operatingSystemVersion})',
       'X-Appwrite-Response-Format': '1.6.0',
     };
 

diff --git a/lib/src/enums/image_format.dart b/lib/src/enums/image_format.dart
@@ -5,7 +5,8 @@ enum ImageFormat {
   jpeg(value: 'jpeg'),
   gif(value: 'gif'),
   png(value: 'png'),
-  webp(value: 'webp');
+  webp(value: 'webp'),
+  avif(value: 'avif');
 
   const ImageFormat({required this.value});
 

diff --git a/lib/src/enums/message_priority.dart b/lib/src/enums/message_priority.dart
@@ -0,0 +1,12 @@
+part of '../../enums.dart';
+
+enum MessagePriority {
+  normal(value: 'normal'),
+  high(value: 'high');
+
+  const MessagePriority({required this.value});
+
+  final String value;
+
+  String toJson() => value;
+}