Merge pull request #72 from appwrite/dev

fix: pong response & chunked upload

Author: christyjacob4

LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2024 Appwrite (https://appwrite.io) and individual contributors.
+Copyright (c) 2025 Appwrite (https://appwrite.io) and individual contributors.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

README.md

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

docs/examples/account/update-mfa-challenge.md

@@ -7,7 +7,7 @@ Client client = Client()
 
 Account account = Account(client);
 
- result = await account.updateMfaChallenge(
+Session result = await account.updateMfaChallenge(
     challengeId: '<CHALLENGE_ID>',
     otp: '<OTP>',
 );

lib/services/account.dart

@@ -282,7 +282,7 @@ class Account extends Service {
   /// the flow, use
   /// [createMfaChallenge](/docs/references/cloud/client-web/account#createMfaChallenge)
   /// method.
-  Future updateMfaChallenge(
+  Future<models.Session> updateMfaChallenge(
       {required String challengeId, required String otp}) async {
     final String apiPath = '/account/mfa/challenge';
 
@@ -298,7 +298,7 @@ class Account extends Service {
     final res = await client.call(HttpMethod.put,
         path: apiPath, params: apiParams, headers: apiHeaders);
 
-    return res.data;
+    return models.Session.fromMap(res.data);
   }
 
   /// List factors

lib/services/functions.dart

@@ -364,6 +364,11 @@ class Functions extends Service {
 
   /// Rebuild deployment
   ///
+  /// Create a new build for an existing function deployment. This endpoint
+  /// allows you to rebuild a deployment with the updated function configuration,
+  /// including its entrypoint and build commands if they have been modified The
+  /// build process will be queued and executed asynchronously. The original
+  /// deployment's code will be preserved and used for the new build.
   Future createBuild(
       {required String functionId,
       required String deploymentId,
@@ -389,6 +394,11 @@ class Functions extends Service {
 
   /// Cancel deployment
   ///
+  /// Cancel an ongoing function deployment build. If the build is already in
+  /// progress, it will be stopped and marked as canceled. If the build hasn't
+  /// started yet, it will be marked as canceled without executing. You cannot
+  /// cancel builds that have already completed (status 'ready') or failed. The
+  /// response includes the final build status and details.
   Future<models.Build> updateDeploymentBuild(
       {required String functionId, required String deploymentId}) async {
     final String apiPath =

lib/services/messaging.dart

@@ -72,7 +72,9 @@ class Messaging extends Service {
 
   /// Update email
   ///
-  /// Update an email message by its unique ID.
+  /// Update an email message by its unique ID. This endpoint only works on
+  /// messages that are in draft status. Messages that are already processing,
+  /// sent, or failed cannot be updated.
   ///
   Future<models.Message> updateEmail(
       {required String messageId,
@@ -173,7 +175,9 @@ class Messaging extends Service {
 
   /// Update push notification
   ///
-  /// Update a push notification by its unique ID.
+  /// Update a push notification by its unique ID. This endpoint only works on
+  /// messages that are in draft status. Messages that are already processing,
+  /// sent, or failed cannot be updated.
   ///
   Future<models.Message> updatePush(
       {required String messageId,
@@ -264,7 +268,9 @@ class Messaging extends Service {
 
   /// Update SMS
   ///
-  /// Update an email message by its unique ID.
+  /// Update an SMS message by its unique ID. This endpoint only works on
+  /// messages that are in draft status. Messages that are already processing,
+  /// sent, or failed cannot be updated.
   ///
   Future<models.Message> updateSms(
       {required String messageId,

lib/services/users.dart

@@ -506,7 +506,7 @@ class Users extends Service {
   /// Delete authenticator
   ///
   /// Delete an authenticator app.
-  Future<models.User> deleteMfaAuthenticator(
+  Future deleteMfaAuthenticator(
       {required String userId, required enums.AuthenticatorType type}) async {
     final String apiPath = '/users/{userId}/mfa/authenticators/{type}'
         .replaceAll('{userId}', userId)
@@ -521,7 +521,7 @@ class Users extends Service {
     final res = await client.call(HttpMethod.delete,
         path: apiPath, params: apiParams, headers: apiHeaders);
 
-    return models.User.fromMap(res.data);
+    return res.data;
   }
 
   /// List factors

lib/src/client.dart

@@ -67,6 +67,9 @@ abstract class Client {
   /// Add headers that should be sent with all API calls.
   Client addHeader(String key, String value);
 
+  /// Sends a "ping" request to Appwrite to verify connectivity.
+  Future<String> ping();
+
   /// Upload a file in chunks.
   Future<Response> chunkedUpload({
     required String path,

lib/src/client_base.dart

@@ -34,6 +34,9 @@ abstract class ClientBase implements Client {
   @override
   ClientBase addHeader(String key, String value);
 
+  @override
+  Future<String> ping();
+
   @override
   Future<Response> call(
     HttpMethod method, {

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.2.0',
+      'x-sdk-version': '13.0.0',
       'X-Appwrite-Response-Format': '1.6.0',
     };
 
@@ -110,6 +110,15 @@ class ClientBrowser extends ClientBase with ClientMixin {
     return this;
   }
 
+  @override
+  Future<String> ping() async {
+    final String apiPath = '/ping';
+    final response = await call(HttpMethod.get,
+        path: apiPath, responseType: ResponseType.plain);
+
+    return response.data;
+  }
+
   @override
   Future<String?> webAuth(Uri url) async {
     final request = http.Request('GET', url);
@@ -147,7 +156,7 @@ class ClientBrowser extends ClientBase with ClientMixin {
     }
 
     var offset = 0;
-    if (idParamName.isNotEmpty && params[idParamName] != 'unique()') {
+    if (idParamName.isNotEmpty) {
       //make a request to check if a file already exists
       try {
         res = await call(