chore: update docs

Author: szuperaz

docs/fileUpload.md

@@ -72,12 +72,22 @@ console.log('file url: ', response.file);
 </html>
 ```
 
-## Upload progress tracking (axios)
+## `axiosRequestConfig` (channel and client uploads)
 
-You can track upload progress by passing axios’s `onUploadProgress` in the optional request config. This works with `client.uploadFile`, `client.uploadImage`, and with `channel.sendFile` / `channel.sendImage`.
+Channel uploads use Axios under the hood. Both **`channel.sendFile`** and **`channel.sendImage`** accept an optional **fifth argument** `axiosRequestConfig` (`AxiosRequestConfig` from axios). The same optional argument exists on **`client.uploadFile`** and **`client.uploadImage`**.
+
+The client merges your config **after** its upload defaults (`timeout: 0`, large `maxContentLength` / `maxBodyLength`, and multipart headers from the form data). Any property you set can override or extend those defaults.
+
+Typical uses:
+
+- **`onUploadProgress`** — track bytes sent (see below)
+- **`signal`** — pass `AbortSignal` from an `AbortController` to cancel an in-flight upload
+- Other Axios per-request options your runtime supports
+
+### Upload progress (`onUploadProgress`)
 
 ```js
-// Client upload with progress
+// client.uploadFile with progress
 const response = await client.uploadFile(file, file.name, file.type, undefined, {
   onUploadProgress: (progressEvent) => {
     const percent = progressEvent.total
@@ -87,7 +97,7 @@ const response = await client.uploadFile(file, file.name, file.type, undefined,
   },
 });
 
-// Channel sendFile with progress
+// channel.sendFile with progress
 const response = await channel.sendFile(file, file.name, file.type, undefined, {
   onUploadProgress: (progressEvent) => {
     const percent = progressEvent.total
@@ -96,6 +106,16 @@ const response = await channel.sendFile(file, file.name, file.type, undefined, {
     console.log(`Upload: ${percent}%`);
   },
 });
+
+// channel.sendImage with progress (same fifth argument)
+const imageResponse = await channel.sendImage(file, file.name, file.type, undefined, {
+  onUploadProgress: (progressEvent) => {
+    const percent = progressEvent.total
+      ? Math.round((progressEvent.loaded * 100) / progressEvent.total)
+      : 0;
+    console.log(`Image upload: ${percent}%`);
+  },
+});
 ```
 
 ## Message composer / attachment manager

src/channel.ts

@@ -246,6 +246,16 @@ export class Channel {
     return await this._sendMessage(message, options);
   }
 
+  /**
+   * 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: string | NodeJS.ReadableStream | Buffer | File,
     name?: string,
@@ -263,6 +273,16 @@ export class Channel {
     );
   }
 
+  /**
+   * 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: string | NodeJS.ReadableStream | File,
     name?: string,