Merge pull request #39 from appwrite/dev

fix: pong response & chunked upload

Author: abnegate

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:

docs/functions.md

@@ -215,6 +215,8 @@ DELETE https://cloud.appwrite.io/v1/functions/{functionId}/deployments/{deployme
 POST https://cloud.appwrite.io/v1/functions/{functionId}/deployments/{deploymentId}/build
 ```
 
+** 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. **
+
 ### Parameters
 
 | Field Name | Type | Description | Default |
@@ -229,6 +231,8 @@ POST https://cloud.appwrite.io/v1/functions/{functionId}/deployments/{deployment
 PATCH https://cloud.appwrite.io/v1/functions/{functionId}/deployments/{deploymentId}/build
 ```
 
+** 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. **
+
 ### Parameters
 
 | Field Name | Type | Description | Default |

docs/messaging.md

@@ -157,7 +157,7 @@ POST https://cloud.appwrite.io/v1/messaging/messages/sms
 PATCH https://cloud.appwrite.io/v1/messaging/messages/sms/{messageId}
 ```
 
-** Update an email message by its unique ID.
+** Update an SMS message by its unique ID.
  **
 
 ### Parameters

src/Appwrite/Client.php

@@ -37,11 +37,11 @@ class Client
      */
     protected array $headers = [
         'content-type' => '',
-        'user-agent' => 'AppwritePHPSDK/12.2.0 ()',
+        'user-agent' => 'AppwritePHPSDK/13.0.0 ()',
         'x-sdk-name'=> 'PHP',
         'x-sdk-platform'=> 'server',
         'x-sdk-language'=> 'php',
-        'x-sdk-version'=> '12.2.0',
+        'x-sdk-version'=> '13.0.0',
     ];
 
     /**

src/Appwrite/Enums/ImageFormat.php

@@ -11,6 +11,7 @@ class ImageFormat implements JsonSerializable
     private static ImageFormat $GIF;
     private static ImageFormat $PNG;
     private static ImageFormat $WEBP;
+    private static ImageFormat $HEIC;
     private static ImageFormat $AVIF;
 
     private string $value;
@@ -65,6 +66,13 @@ public static function WEBP(): ImageFormat
         }
         return self::$WEBP;
     }
+    public static function HEIC(): ImageFormat
+    {
+        if (!isset(self::$HEIC)) {
+            self::$HEIC = new ImageFormat('heic');
+        }
+        return self::$HEIC;
+    }
     public static function AVIF(): ImageFormat
     {
         if (!isset(self::$AVIF)) {

src/Appwrite/Services/Account.php

@@ -441,9 +441,9 @@ public function createMfaChallenge(AuthenticationFactor $factor): array
      * @param string $challengeId
      * @param string $otp
      * @throws AppwriteException
-     * @return string
+     * @return array
      */
-    public function updateMfaChallenge(string $challengeId, string $otp): string
+    public function updateMfaChallenge(string $challengeId, string $otp): array
     {
         $apiPath = str_replace(
             [],

src/Appwrite/Services/Functions.php

@@ -570,7 +570,7 @@ public function createDeployment(string $functionId, InputFile $code, bool $acti
                     'progress' => min(((($counter * Client::CHUNK_SIZE) + Client::CHUNK_SIZE)), $size) / $size * 100,
                     'sizeUploaded' => min($counter * Client::CHUNK_SIZE),
                     'chunksTotal' => $response['chunksTotal'],
-                    'chunksUploaded' => $response['chunksUploaded'], 
+                    'chunksUploaded' => $response['chunksUploaded'],
                 ]);
             }
         }
@@ -685,6 +685,12 @@ public function deleteDeployment(string $functionId, string $deploymentId): stri
     /**
      * 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.
+     *
      * @param string $functionId
      * @param string $deploymentId
      * @param ?string $buildId
@@ -721,6 +727,12 @@ public function createBuild(string $functionId, string $deploymentId, ?string $b
     /**
      * 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.
+     *
      * @param string $functionId
      * @param string $deploymentId
      * @throws AppwriteException

src/Appwrite/Services/Messaging.php

@@ -526,7 +526,7 @@ public function createSms(string $messageId, string $content, ?array $topics = n
     /**
      * Update SMS
      *
-     * Update an email message by its unique ID.
+     * Update an SMS message by its unique ID.
      * 
      *
      * @param string $messageId

src/Appwrite/Services/Storage.php

@@ -385,12 +385,10 @@ public function createFile(string $bucketId, string $fileId, InputFile $file, ?a
         $id = '';
         $counter = 0;
 
-        if($fileId != 'unique()') {
-            try {
-                $response = $this->client->call(Client::METHOD_GET, $apiPath . '/' . $fileId);
-                $counter = $response['chunksUploaded'] ?? 0;
-            } catch(\Exception $e) {
-            }
+        try {
+            $response = $this->client->call(Client::METHOD_GET, $apiPath . '/' . $fileId);
+            $counter = $response['chunksUploaded'] ?? 0;
+        } catch(\Exception $e) {
         }
 
         $apiHeaders = ['content-type' => 'multipart/form-data'];
@@ -426,7 +424,7 @@ public function createFile(string $bucketId, string $fileId, InputFile $file, ?a
                     'progress' => min(((($counter * Client::CHUNK_SIZE) + Client::CHUNK_SIZE)), $size) / $size * 100,
                     'sizeUploaded' => min($counter * Client::CHUNK_SIZE),
                     'chunksTotal' => $response['chunksTotal'],
-                    'chunksUploaded' => $response['chunksUploaded'], 
+                    'chunksUploaded' => $response['chunksUploaded'],
                 ]);
             }
         }

src/Appwrite/Services/Users.php

@@ -790,9 +790,9 @@ public function updateMfa(string $userId, bool $mfa): array
      * @param string $userId
      * @param AuthenticatorType $type
      * @throws AppwriteException
-     * @return array
+     * @return string
      */
-    public function deleteMfaAuthenticator(string $userId, AuthenticatorType $type): array
+    public function deleteMfaAuthenticator(string $userId, AuthenticatorType $type): string
     {
         $apiPath = str_replace(
             ['{userId}', '{type}'],