@hautechai/sdk 2.21.8 → 2.21.10

package/README.md

@@ -61,6 +61,12 @@ const sdk = createSDK({ authToken: () => accountToken }); // you should call the
 
 Docs about how to use the SDK are available [here](https://docs.hautech.ai/)
 
+### Uploading files
+
+- In browsers, prefer passing a `File` object to methods like `sdk.images.createFromFile` and `sdk.videos.createFromFile`. The `File.name` will be included in the multipart upload automatically.
+- If you pass a `Blob` in the browser, some environments may set the filename to a default value (e.g., `"blob"`). To control the filename when using a `Blob`, wrap it in an object with explicit metadata on server-side, or construct a `File` from the `Blob`.
+- In Node.js, when you pass a string path (e.g., `/path/to/image.png`), the SDK sets the multipart filename to the basename of the path (e.g., `image.png`). You can also pass an object with `{ stream, filename, contentType }` to control metadata explicitly.
+
 ## Development
 
 ### Prerequisites

package/dist/index.d.mts

@@ -7600,6 +7600,10 @@ interface ImageEntity {
     createdAt: string;
     updatedAt: string;
     format: string;
+    /** @nullable */
+    originalFilenameBase?: string | null;
+    /** @nullable */
+    originalFilenameExt?: string | null;
     width: number;
     height: number;
     url: string;

package/dist/index.d.ts

@@ -7600,6 +7600,10 @@ interface ImageEntity {
     createdAt: string;
     updatedAt: string;
     format: string;
+    /** @nullable */
+    originalFilenameBase?: string | null;
+    /** @nullable */
+    originalFilenameExt?: string | null;
     width: number;
     height: number;
     url: string;

package/dist/index.js

@@ -10853,7 +10853,10 @@ var useVideosApi = () => {
       if (typeof file === "string") {
         if (isBrowser) throw new Error("Cannot use file path in browser");
         const fs = require("fs");
-        formData.append("file", fs.createReadStream(file));
+        const path = require("path");
+        formData.append("file", fs.createReadStream(file), {
+          filename: path.basename(file)
+        });
       } else if (isBrowser && file instanceof Blob) {
         formData.append("file", file);
       } else if (!(file instanceof Blob) && typeof file === "object" && "stream" in file) {
@@ -11281,7 +11284,10 @@ var useImagesApi = () => {
       if (typeof file === "string") {
         if (isBrowser) throw new Error("Cannot use file path in browser");
         const fs = require("fs");
-        formData.append("file", fs.createReadStream(file));
+        const path = require("path");
+        formData.append("file", fs.createReadStream(file), {
+          filename: path.basename(file)
+        });
       } else if (isBrowser && file instanceof Blob) {
         formData.append("file", file);
       } else if (typeof file === "object" && "filename" in file) {