stream-chat 9.40.0 → 9.41.0

package/dist/esm/index.mjs

@@ -3213,12 +3213,18 @@ var _AttachmentManager = class _AttachmentManager {
      * Method to perform the default upload behavior without checking for custom upload functions
      * to prevent recursive calls
      */
-    this.doDefaultUploadRequest = async (fileLike) => {
+    this.doDefaultUploadRequest = async (fileLike, options) => {
+      const progressHandler = options?.onProgress ? (progressEvent) => {
+        const percent = progressEvent.lengthComputable && progressEvent.total ? Math.round(progressEvent.loaded * 100 / progressEvent.total) : void 0;
+        options.onProgress?.(percent);
+      } : void 0;
       if (isFileReference(fileLike)) {
         return this.channel[isImageFile(fileLike) ? "sendImage" : "sendFile"](
           fileLike.uri,
           fileLike.name,
-          fileLike.type
+          fileLike.type,
+          void 0,
+          progressHandler ? { onUploadProgress: progressHandler } : void 0
         );
       }
       const file = isFile(fileLike) ? fileLike : createFileFromBlobs({
@@ -3226,18 +3232,24 @@ var _AttachmentManager = class _AttachmentManager {
         fileName: generateFileName(fileLike.type),
         mimeType: fileLike.type
       });
-      const { duration, ...result } = await this.channel[isImageFile(fileLike) ? "sendImage" : "sendFile"](file);
+      const { duration, ...result } = await this.channel[isImageFile(fileLike) ? "sendImage" : "sendFile"](
+        file,
+        void 0,
+        void 0,
+        void 0,
+        progressHandler ? { onUploadProgress: progressHandler } : void 0
+      );
       return result;
     };
     /**
      * todo: docs how to customize the image and file upload by overriding do
      */
-    this.doUploadRequest = async (fileLike) => {
+    this.doUploadRequest = async (fileLike, options) => {
       const customUploadFn = this.config.doUploadRequest;
       if (customUploadFn) {
-        return await customUploadFn(fileLike);
+        return await customUploadFn(fileLike, options);
       }
-      return this.doDefaultUploadRequest(fileLike);
+      return this.doDefaultUploadRequest(fileLike, options);
     };
     // @deprecated use attachmentManager.uploadFile(file)
     this.uploadAttachment = async (attachment) => {
@@ -3261,25 +3273,41 @@ var _AttachmentManager = class _AttachmentManager {
         });
         return localAttachment;
       }
-      this.upsertAttachments([
-        {
-          ...attachment,
-          localMetadata: {
-            ...attachment.localMetadata,
-            uploadState: "uploading"
-          }
+      const shouldTrackProgress = this.config.trackUploadProgress;
+      const uploadingAttachment = {
+        ...attachment,
+        localMetadata: {
+          ...attachment.localMetadata,
+          uploadState: "uploading",
+          ...shouldTrackProgress && { uploadProgress: 0 }
         }
-      ]);
+      };
+      this.upsertAttachments([uploadingAttachment]);
+      const uploadOptions = shouldTrackProgress ? {
+        onProgress: (percent) => {
+          this.updateAttachment({
+            ...uploadingAttachment,
+            localMetadata: {
+              ...uploadingAttachment.localMetadata,
+              uploadProgress: percent
+            }
+          });
+        }
+      } : void 0;
       let response;
       try {
-        response = await this.doUploadRequest(localAttachment.localMetadata.file);
+        response = await this.doUploadRequest(
+          localAttachment.localMetadata.file,
+          uploadOptions
+        );
       } catch (error) {
         const reason = error instanceof Error ? error.message : "unknown error";
         const failedAttachment = {
           ...attachment,
           localMetadata: {
             ...attachment.localMetadata,
-            uploadState: "failed"
+            uploadState: "failed",
+            uploadProgress: void 0
           }
         };
         this.client.notifications.addError({
@@ -3305,7 +3333,8 @@ var _AttachmentManager = class _AttachmentManager {
         ...attachment,
         localMetadata: {
           ...attachment.localMetadata,
-          uploadState: "finished"
+          uploadState: "finished",
+          uploadProgress: void 0
         }
       };
       const previewUri = uploadedAttachment.localMetadata.previewUri;
@@ -3339,18 +3368,31 @@ var _AttachmentManager = class _AttachmentManager {
         this.upsertAttachments([attachment]);
         return preUpload.state.attachment;
       }
+      const shouldTrackProgress = this.config.trackUploadProgress;
       attachment = {
         ...attachment,
         localMetadata: {
           ...attachment.localMetadata,
-          uploadState: "uploading"
+          uploadState: "uploading",
+          ...shouldTrackProgress && { uploadProgress: 0 }
         }
       };
       this.upsertAttachments([attachment]);
+      const uploadOptions = shouldTrackProgress ? {
+        onProgress: (percent) => {
+          this.updateAttachment({
+            ...attachment,
+            localMetadata: {
+              ...attachment.localMetadata,
+              uploadProgress: percent
+            }
+          });
+        }
+      } : void 0;
       let response;
       let error;
       try {
-        response = await this.doUploadRequest(file);
+        response = await this.doUploadRequest(file, uploadOptions);
       } catch (err) {
         error = err instanceof Error ? err : void 0;
       }
@@ -3361,7 +3403,8 @@ var _AttachmentManager = class _AttachmentManager {
             ...attachment,
             localMetadata: {
               ...attachment.localMetadata,
-              uploadState: error ? "failed" : "finished"
+              uploadState: error ? "failed" : "finished",
+              uploadProgress: void 0
             }
           },
           error,
@@ -3529,7 +3572,8 @@ var DEFAULT_ATTACHMENT_MANAGER_CONFIG = {
   acceptedFiles: [],
   // an empty array means all files are accepted
   fileUploadFilter: () => true,
-  maxNumberOfFilesPerMessage: API_MAX_FILES_ALLOWED_PER_MESSAGE
+  maxNumberOfFilesPerMessage: API_MAX_FILES_ALLOWED_PER_MESSAGE,
+  trackUploadProgress: true
 };
 var DEFAULT_TEXT_COMPOSER_CONFIG = {
   enabled: true,
@@ -7988,22 +8032,44 @@ var Channel = class {
     }
     return await this._sendMessage(message, options);
   }
-  sendFile(uri, name, contentType, user) {
+  /**
+   * Upload a file to this channel’s file endpoint (multipart). Forwards to the client’s `sendFile` implementation.
+   *
+   * @param uri File source: URL string, `File`, `Buffer`, or readable stream (Node).
+   * @param name File name sent in the multipart body.
+   * @param contentType MIME type; defaults are applied when omitted.
+   * @param user Optional user payload appended to the form as JSON.
+   * @param axiosRequestConfig Optional Axios per-request config, merged after upload defaults (e.g. `onUploadProgress`, `signal` from `AbortController`).
+   * @return Promise resolving to `{ file: string, ... }` with the CDN URL.
+   */
+  sendFile(uri, name, contentType, user, axiosRequestConfig) {
     return this.getClient().sendFile(
       `${this._channelURL()}/file`,
       uri,
       name,
       contentType,
-      user
+      user,
+      axiosRequestConfig
     );
   }
-  sendImage(uri, name, contentType, user) {
+  /**
+   * Upload an image to this channel’s image endpoint (multipart). Uses the same transport as `sendFile`.
+   *
+   * @param uri Image source: URL string, `File`, or readable stream (Node). For `Buffer` uploads, use `sendFile` toward the channel file endpoint instead.
+   * @param name File name sent in the multipart body.
+   * @param contentType MIME type.
+   * @param user Optional user payload appended to the form as JSON.
+   * @param axiosRequestConfig Optional Axios per-request config, merged after upload defaults (e.g. `onUploadProgress`, `signal`).
+   * @return Promise resolving to `{ file: string, ... }` with the CDN URL.
+   */
+  sendImage(uri, name, contentType, user, axiosRequestConfig) {
     return this.getClient().sendFile(
       `${this._channelURL()}/image`,
       uri,
       name,
       contentType,
-      user
+      user,
+      axiosRequestConfig
     );
   }
   deleteFile(url) {
@@ -13544,7 +13610,7 @@ var StreamChat = class _StreamChat {
   delete(url, params) {
     return this.doAxiosRequest("delete", url, null, { params });
   }
-  sendFile(url, uri, name, contentType, user) {
+  sendFile(url, uri, name, contentType, user, axiosRequestConfig) {
     const data = addFileToFormData(uri, name, contentType || "multipart/form-data");
     if (user != null) data.append("user", JSON.stringify(user));
     return this.doAxiosRequest("postForm", url, data, {
@@ -13553,7 +13619,8 @@ var StreamChat = class _StreamChat {
       config: {
         timeout: 0,
         maxContentLength: Infinity,
-        maxBodyLength: Infinity
+        maxBodyLength: Infinity,
+        ...axiosRequestConfig
       }
     });
   }
@@ -14982,7 +15049,7 @@ var StreamChat = class _StreamChat {
     if (this.userAgent) {
       return this.userAgent;
     }
-    const version = "9.40.0";
+    const version = "9.41.0";
     const clientBundle = "browser-esm";
     let userAgentString = "";
     if (this.sdkIdentifier) {
@@ -16120,11 +16187,19 @@ var StreamChat = class _StreamChat {
    * @param {string} [name] The name of the file
    * @param {string} [contentType] The content type of the file
    * @param {UserResponse} [user] Optional user information
+   * @param {AxiosRequestConfig} [axiosRequestConfig] Optional axios config (e.g. onUploadProgress for progress tracking)
    *
    * @return {Promise<SendFileAPIResponse>} Response containing the file URL
    */
-  uploadFile(uri, name, contentType, user) {
-    return this.sendFile(`${this.baseURL}/uploads/file`, uri, name, contentType, user);
+  uploadFile(uri, name, contentType, user, axiosRequestConfig) {
+    return this.sendFile(
+      `${this.baseURL}/uploads/file`,
+      uri,
+      name,
+      contentType,
+      user,
+      axiosRequestConfig
+    );
   }
   /**
    * uploadImage - Uploads an image to the configured storage (defaults to Stream CDN)
@@ -16133,11 +16208,19 @@ var StreamChat = class _StreamChat {
    * @param {string} [name] The name of the image
    * @param {string} [contentType] The content type of the image
    * @param {UserResponse} [user] Optional user information
+   * @param {AxiosRequestConfig} [axiosRequestConfig] Optional axios config (e.g. onUploadProgress for progress tracking)
    *
    * @return {Promise<SendFileAPIResponse>} Response containing the image URL
    */
-  uploadImage(uri, name, contentType, user) {
-    return this.sendFile(`${this.baseURL}/uploads/image`, uri, name, contentType, user);
+  uploadImage(uri, name, contentType, user, axiosRequestConfig) {
+    return this.sendFile(
+      `${this.baseURL}/uploads/image`,
+      uri,
+      name,
+      contentType,
+      user,
+      axiosRequestConfig
+    );
   }
   /**
    * deleteFile - Deletes a file from the configured storage