@gradio/client 0.17.0 → 0.19.0

package/dist/index.js

@@ -5,16 +5,23 @@ var __publicField = (obj, key, value) => {
   return value;
 };
 var fn = new Intl.Collator(0, { numeric: 1 }).compare;
-function semiver$1(a, b, bool) {
+function semiver(a, b, bool) {
   a = a.split(".");
   b = b.split(".");
   return fn(a[0], b[0]) || fn(a[1], b[1]) || (b[2] = b.slice(2).join("."), bool = /[.-]/.test(a[2] = a.slice(2).join(".")), bool == /[.-]/.test(b[2]) ? fn(a[2], b[2]) : bool ? -1 : 1);
 }
+const UPLOAD_URL = "upload";
 const CONFIG_URL = "config";
 const API_INFO_URL = "info";
+const RUNTIME_URL = "runtime";
+const SLEEPTIME_URL = "sleeptime";
 const SPACE_FETCHER_URL = "https://gradio-space-api-fetcher-v2.hf.space/api";
-const QUEUE_FULL_MSG = "This application is too busy. Keep trying!";
-const BROKEN_CONNECTION_MSG = "Connection errored out.";
+const QUEUE_FULL_MSG = "This application is currently busy. Please try again. ";
+const BROKEN_CONNECTION_MSG = "Connection errored out. ";
+const CONFIG_ERROR_MSG = "Could not resolve app config. ";
+const SPACE_STATUS_ERROR_MSG = "Could not get space status. ";
+const API_INFO_ERROR_MSG = "Could not get API info. ";
+const SPACE_METADATA_ERROR_MSG = "Space metadata could not be loaded. ";
 function resolve_root(base_url, root_path, prioritize_base) {
   if (root_path.startsWith("http://") || root_path.startsWith("https://")) {
     return prioritize_base ? base_url : root_path;
@@ -31,7 +38,6 @@ async function get_jwt(space, token) {
     const jwt = (await r.json()).token;
     return jwt || false;
   } catch (e) {
-    console.error(e);
     return false;
   }
 }
@@ -53,21 +59,18 @@ async function resolve_config(endpoint) {
     config.root = config_root;
     return { ...config, path };
   } else if (endpoint) {
-    const response = await this.fetch_implementation(
-      `${endpoint}/${CONFIG_URL}`,
-      {
-        headers
-      }
-    );
+    const response = await this.fetch(`${endpoint}/${CONFIG_URL}`, {
+      headers
+    });
     if ((response == null ? void 0 : response.status) === 200) {
       let config = await response.json();
       config.path = config.path ?? "";
       config.root = endpoint;
       return config;
     }
-    throw new Error("Could not get config.");
+    throw new Error(CONFIG_ERROR_MSG);
   }
-  throw new Error("No config or app endpoint found");
+  throw new Error(CONFIG_ERROR_MSG);
 }
 function determine_protocol(endpoint) {
   if (endpoint.startsWith("http")) {
@@ -112,15 +115,15 @@ async function process_endpoint(app_reference, hf_token) {
         `https://huggingface.co/api/spaces/${_app_reference}/host`,
         { headers }
       );
-      if (res.status !== 200)
-        throw new Error("Space metadata could not be loaded.");
       const _host = (await res.json()).host;
       return {
         space_id: app_reference,
         ...determine_protocol(_host)
       };
     } catch (e) {
-      throw new Error("Space metadata could not be loaded." + e.message);
+      throw new Error(
+        "Space metadata could not be loaded. " + e.message
+      );
     }
   }
   if (RE_SPACE_DOMAIN.test(_app_reference)) {
@@ -314,6 +317,45 @@ function handle_message(data, last_status) {
   }
   return { type: "none", status: { stage: "error", queue } };
 }
+const map_data_to_params = (data, api_info) => {
+  const parameters = Object.values(api_info.named_endpoints).flatMap(
+    (values) => values.parameters
+  );
+  if (Array.isArray(data)) {
+    if (data.length > parameters.length) {
+      console.warn("Too many arguments provided for the endpoint.");
+    }
+    return data;
+  }
+  const resolved_data = [];
+  const provided_keys = Object.keys(data);
+  parameters.forEach((param, index) => {
+    if (data.hasOwnProperty(param.parameter_name)) {
+      resolved_data[index] = data[param.parameter_name];
+    } else if (param.parameter_has_default) {
+      resolved_data[index] = param.parameter_default;
+    } else {
+      throw new Error(
+        `No value provided for required parameter: ${param.parameter_name}`
+      );
+    }
+  });
+  provided_keys.forEach((key) => {
+    if (!parameters.some((param) => param.parameter_name === key)) {
+      throw new Error(
+        `Parameter \`${key}\` is not a valid keyword argument. Please refer to the API for usage.`
+      );
+    }
+  });
+  resolved_data.forEach((value, idx) => {
+    if (value === void 0 && !parameters[idx].parameter_has_default) {
+      throw new Error(
+        `No value provided for required parameter: ${parameters[idx].parameter_name}`
+      );
+    }
+  });
+  return resolved_data;
+};
 async function view_api() {
   if (this.api_info)
     return this.api_info;
@@ -328,8 +370,8 @@ async function view_api() {
   }
   try {
     let response;
-    if (semiver$1((config == null ? void 0 : config.version) || "2.0.0", "3.30") < 0) {
-      response = await this.fetch_implementation(SPACE_FETCHER_URL, {
+    if (semiver((config == null ? void 0 : config.version) || "2.0.0", "3.30") < 0) {
+      response = await this.fetch(SPACE_FETCHER_URL, {
         method: "POST",
         body: JSON.stringify({
           serialize: false,
@@ -338,12 +380,9 @@ async function view_api() {
         headers
       });
     } else {
-      response = await this.fetch_implementation(
-        `${config == null ? void 0 : config.root}/${API_INFO_URL}`,
-        {
-          headers
-        }
-      );
+      response = await this.fetch(`${config == null ? void 0 : config.root}/${API_INFO_URL}`, {
+        headers
+      });
     }
     if (!response.ok) {
       throw new Error(BROKEN_CONNECTION_MSG);
@@ -361,12 +400,14 @@ async function view_api() {
   }
 }
 async function upload_files(root_url, files, upload_id) {
+  var _a;
   const headers = {};
-  if (this.options.hf_token) {
+  if ((_a = this == null ? void 0 : this.options) == null ? void 0 : _a.hf_token) {
     headers.Authorization = `Bearer ${this.options.hf_token}`;
   }
   const chunkSize = 1e3;
   const uploadResponses = [];
+  let response;
   for (let i = 0; i < files.length; i += chunkSize) {
     const chunk = files.slice(i, i + chunkSize);
     const formData = new FormData();
@@ -374,17 +415,18 @@ async function upload_files(root_url, files, upload_id) {
       formData.append("files", file);
     });
     try {
-      const upload_url = upload_id ? `${root_url}/upload?upload_id=${upload_id}` : `${root_url}/upload`;
-      var response = await this.fetch_implementation(upload_url, {
+      const upload_url = upload_id ? `${root_url}/upload?upload_id=${upload_id}` : `${root_url}/${UPLOAD_URL}`;
+      response = await this.fetch(upload_url, {
         method: "POST",
         body: formData,
         headers
       });
     } catch (e) {
-      return { error: BROKEN_CONNECTION_MSG };
+      throw new Error(BROKEN_CONNECTION_MSG + e.message);
     }
     if (!response.ok) {
-      return { error: await response.text() };
+      const error_text = await response.text();
+      return { error: `HTTP ${response.status}: ${error_text}` };
     }
     const output = await response.json();
     if (output) {
@@ -393,87 +435,7 @@ async function upload_files(root_url, files, upload_id) {
   }
   return { files: uploadResponses };
 }
-function update_object(object, newValue, stack) {
-  while (stack.length > 1) {
-    const key2 = stack.shift();
-    if (typeof key2 === "string" || typeof key2 === "number") {
-      object = object[key2];
-    } else {
-      throw new Error("Invalid key type");
-    }
-  }
-  const key = stack.shift();
-  if (typeof key === "string" || typeof key === "number") {
-    object[key] = newValue;
-  } else {
-    throw new Error("Invalid key type");
-  }
-}
-async function walk_and_store_blobs(param, type = void 0, path = [], root = false, endpoint_info = void 0) {
-  if (Array.isArray(param)) {
-    let blob_refs = [];
-    await Promise.all(
-      param.map(async (item) => {
-        var _a;
-        let new_path = path.slice();
-        new_path.push(item);
-        const array_refs = await walk_and_store_blobs(
-          param[item],
-          root ? ((_a = endpoint_info == null ? void 0 : endpoint_info.parameters[item]) == null ? void 0 : _a.component) || void 0 : type,
-          new_path,
-          false,
-          endpoint_info
-        );
-        blob_refs = blob_refs.concat(array_refs);
-      })
-    );
-    return blob_refs;
-  } else if (globalThis.Buffer && param instanceof globalThis.Buffer) {
-    const is_image = type === "Image";
-    return [
-      {
-        path,
-        blob: is_image ? false : new NodeBlob([param]),
-        type
-      }
-    ];
-  } else if (typeof param === "object") {
-    let blob_refs = [];
-    for (let key in param) {
-      if (param.hasOwnProperty(key)) {
-        let new_path = path.slice();
-        new_path.push(key);
-        blob_refs = blob_refs.concat(
-          await walk_and_store_blobs(
-            // @ts-ignore
-            param[key],
-            void 0,
-            new_path,
-            false,
-            endpoint_info
-          )
-        );
-      }
-    }
-    return blob_refs;
-  }
-  return [];
-}
-function skip_queue(id, config) {
-  var _a, _b, _c, _d;
-  return !(((_b = (_a = config == null ? void 0 : config.dependencies) == null ? void 0 : _a[id]) == null ? void 0 : _b.queue) === null ? config.enable_queue : (_d = (_c = config == null ? void 0 : config.dependencies) == null ? void 0 : _c[id]) == null ? void 0 : _d.queue) || false;
-}
-function post_message(message, origin) {
-  return new Promise((res, _rej) => {
-    const channel = new MessageChannel();
-    channel.port1.onmessage = ({ data }) => {
-      channel.port1.close();
-      res(data);
-    };
-    window.parent.postMessage(message, origin, [channel.port2]);
-  });
-}
-async function upload(file_data, root_url, upload_id, max_file_size, upload_fn = upload_files) {
+async function upload(file_data, root_url, upload_id, max_file_size) {
   let files = (Array.isArray(file_data) ? file_data : [file_data]).map(
     (file_data2) => file_data2.blob
   );
@@ -486,7 +448,7 @@ async function upload(file_data, root_url, upload_id, max_file_size, upload_fn =
     );
   }
   return await Promise.all(
-    await upload_fn(root_url, files, upload_id).then(
+    await this.upload_files(root_url, files, upload_id).then(
       async (response) => {
         if (response.error) {
           throw new Error(response.error);
@@ -549,6 +511,95 @@ class FileData {
     this.alt_text = alt_text;
   }
 }
+function update_object(object, newValue, stack) {
+  while (stack.length > 1) {
+    const key2 = stack.shift();
+    if (typeof key2 === "string" || typeof key2 === "number") {
+      object = object[key2];
+    } else {
+      throw new Error("Invalid key type");
+    }
+  }
+  const key = stack.shift();
+  if (typeof key === "string" || typeof key === "number") {
+    object[key] = newValue;
+  } else {
+    throw new Error("Invalid key type");
+  }
+}
+async function walk_and_store_blobs(data, type = void 0, path = [], root = false, endpoint_info = void 0) {
+  if (Array.isArray(data)) {
+    let blob_refs = [];
+    await Promise.all(
+      data.map(async (item) => {
+        var _a;
+        let new_path = path.slice();
+        new_path.push(item);
+        const array_refs = await walk_and_store_blobs(
+          data[item],
+          root ? ((_a = endpoint_info == null ? void 0 : endpoint_info.parameters[item]) == null ? void 0 : _a.component) || void 0 : type,
+          new_path,
+          false,
+          endpoint_info
+        );
+        blob_refs = blob_refs.concat(array_refs);
+      })
+    );
+    return blob_refs;
+  } else if (globalThis.Buffer && data instanceof globalThis.Buffer || data instanceof Blob) {
+    const is_image = type === "Image";
+    return [
+      {
+        path,
+        blob: is_image ? false : new NodeBlob([data]),
+        type
+      }
+    ];
+  } else if (typeof data === "object" && data !== null) {
+    let blob_refs = [];
+    for (const key of Object.keys(data)) {
+      const new_path = [...path, key];
+      const value = data[key];
+      blob_refs = blob_refs.concat(
+        await walk_and_store_blobs(
+          value,
+          void 0,
+          new_path,
+          false,
+          endpoint_info
+        )
+      );
+    }
+    if (!blob_refs.length && !(data instanceof Blob || data instanceof ArrayBuffer || data instanceof Uint8Array)) {
+      return [
+        {
+          path,
+          blob: new NodeBlob([JSON.stringify(data)]),
+          type: typeof data
+        }
+      ];
+    }
+    return blob_refs;
+  }
+  return [];
+}
+function skip_queue(id, config) {
+  var _a, _b;
+  if (((_b = (_a = config == null ? void 0 : config.dependencies) == null ? void 0 : _a[id]) == null ? void 0 : _b.queue) !== null) {
+    return !config.dependencies[id].queue;
+  }
+  return !config.enable_queue;
+}
+function post_message(message, origin) {
+  return new Promise((res, _rej) => {
+    const channel = new MessageChannel();
+    channel.port1.onmessage = ({ data }) => {
+      channel.port1.close();
+      res(data);
+    };
+    window.parent.postMessage(message, origin, [channel.port2]);
+  });
+}
 async function handle_blob(endpoint, data, api_info) {
   const self = this;
   const blobRefs = await walk_and_store_blobs(
@@ -568,7 +619,7 @@ async function handle_blob(endpoint, data, api_info) {
         path,
         file_url,
         type,
-        name: blob == null ? void 0 : blob.name
+        name: blob instanceof File ? blob == null ? void 0 : blob.name : void 0
       };
     })
   );
@@ -588,7 +639,7 @@ async function post_data(url, body, additional_headers) {
     headers.Authorization = `Bearer ${this.options.hf_token}`;
   }
   try {
-    var response = await this.fetch_implementation(url, {
+    var response = await this.fetch(url, {
       method: "POST",
       body: JSON.stringify(body),
       headers: { ...headers, ...additional_headers }
@@ -626,7 +677,7 @@ async function predict(endpoint, data) {
     );
   }
   return new Promise(async (resolve, reject) => {
-    const app = this.submit(endpoint, data || []);
+    const app = this.submit(endpoint, data);
     let result;
     app.on("data", (d) => {
       if (status_complete) {
@@ -663,7 +714,7 @@ async function check_space_status(id, type, status_callback) {
     status_callback({
       status: "error",
       load_status: "error",
-      message: "Could not get space status",
+      message: SPACE_STATUS_ERROR_MSG,
       detail: "NOT_FOUND"
     });
     return;
@@ -751,7 +802,7 @@ async function get_space_hardware(space_id, hf_token) {
   }
   try {
     const res = await fetch(
-      `https://huggingface.co/api/spaces/${space_id}/runtime`,
+      `https://huggingface.co/api/spaces/${space_id}/${RUNTIME_URL}`,
       { headers }
     );
     if (res.status !== 200)
@@ -772,7 +823,7 @@ async function set_space_timeout(space_id, timeout, hf_token) {
   };
   try {
     const res = await fetch(
-      `https://huggingface.co/api/spaces/${space_id}/sleeptime`,
+      `https://huggingface.co/api/spaces/${space_id}/${SLEEPTIME_URL}`,
       {
         method: "POST",
         headers: { "Content-Type": "application/json", ...headers },
@@ -827,8 +878,12 @@ async function duplicate(app_reference, options) {
     body.private = true;
   }
   let original_hardware;
-  if (!hardware) {
-    original_hardware = await get_space_hardware(app_reference, hf_token);
+  try {
+    if (!hardware) {
+      original_hardware = await get_space_hardware(app_reference, hf_token);
+    }
+  } catch (e) {
+    throw Error(SPACE_METADATA_ERROR_MSG + e.message);
   }
   const requested_hardware = hardware || original_hardware || "cpu-basic";
   body.hardware = requested_hardware;
@@ -854,58 +909,73 @@ async function duplicate(app_reference, options) {
     }
     const duplicated_space = await response.json();
     await set_space_timeout(`${user}/${space_name}`, timeout || 300, hf_token);
-    return await Client.connect(duplicated_space.url, options);
+    return await Client.connect(
+      get_space_reference(duplicated_space.url),
+      options
+    );
   } catch (e) {
     throw new Error(e);
   }
 }
-function open_stream() {
+function get_space_reference(url) {
+  const regex = /https:\/\/huggingface.co\/spaces\/([^/]+\/[^/]+)/;
+  const match = url.match(regex);
+  if (match) {
+    return match[1];
+  }
+}
+async function open_stream() {
   let {
     event_callbacks,
     unclosed_events,
     pending_stream_messages,
     stream_status,
-    config
+    config,
+    jwt
   } = this;
   if (!config) {
     throw new Error("Could not resolve app config");
   }
   stream_status.open = true;
-  let event_source = null;
+  let stream = null;
   let params = new URLSearchParams({
     session_hash: this.session_hash
   }).toString();
   let url = new URL(`${config.root}/queue/data?${params}`);
-  event_source = this.eventSource_factory(url);
-  if (!event_source) {
-    throw new Error("Cannot connect to sse endpoint: " + url.toString());
+  if (jwt) {
+    url.searchParams.set("__sign", jwt);
+  }
+  stream = await this.stream(url);
+  if (!stream) {
+    console.warn("Cannot connect to SSE endpoint: " + url.toString());
+    return;
   }
-  event_source.onmessage = async function(event) {
+  stream.onmessage = async function(event) {
     let _data = JSON.parse(event.data);
     if (_data.msg === "close_stream") {
-      close_stream(stream_status, event_source);
+      close_stream(stream_status, stream);
       return;
     }
     const event_id = _data.event_id;
     if (!event_id) {
       await Promise.all(
         Object.keys(event_callbacks).map(
-          (event_id2) => (
-            // @ts-ignore
-            event_callbacks[event_id2](_data)
-          )
-          // todo: check event_callbacks
+          (event_id2) => event_callbacks[event_id2](_data)
         )
       );
     } else if (event_callbacks[event_id] && config) {
       if (_data.msg === "process_completed" && ["sse", "sse_v1", "sse_v2", "sse_v2.1"].includes(config.protocol)) {
         unclosed_events.delete(event_id);
         if (unclosed_events.size === 0) {
-          close_stream(stream_status, event_source);
+          close_stream(stream_status, stream);
         }
       }
       let fn2 = event_callbacks[event_id];
-      window.setTimeout(fn2, 0, _data);
+      if (typeof window !== "undefined") {
+        window.setTimeout(fn2, 0, _data);
+      } else {
+        setImmediate(fn2, _data);
+      }
     } else {
       if (!pending_stream_messages[event_id]) {
         pending_stream_messages[event_id] = [];
@@ -913,25 +983,22 @@ function open_stream() {
       pending_stream_messages[event_id].push(_data);
     }
   };
-  event_source.onerror = async function() {
+  stream.onerror = async function() {
     await Promise.all(
       Object.keys(event_callbacks).map(
-        (event_id) => (
-          // @ts-ignore
-          event_callbacks[event_id]({
-            msg: "unexpected_error",
-            message: BROKEN_CONNECTION_MSG
-          })
-        )
+        (event_id) => event_callbacks[event_id]({
+          msg: "unexpected_error",
+          message: BROKEN_CONNECTION_MSG
+        })
       )
     );
-    close_stream(stream_status, event_source);
+    close_stream(stream_status, stream);
   };
 }
-function close_stream(stream_status, event_source) {
-  if (stream_status && event_source) {
+function close_stream(stream_status, stream) {
+  if (stream_status && stream) {
     stream_status.open = false;
-    event_source == null ? void 0 : event_source.close();
+    stream == null ? void 0 : stream.close();
   }
 }
 function apply_diff_stream(pending_diff_streams, event_id, data) {
@@ -1023,7 +1090,7 @@ function submit(endpoint, data, event_data, trigger_id) {
     };
     const { hf_token } = this.options;
     const {
-      fetch_implementation,
+      fetch: fetch2,
       app_reference,
       config,
       session_hash,
@@ -1046,8 +1113,9 @@ function submit(endpoint, data, event_data, trigger_id) {
       api_map,
       config
     );
+    let resolved_data = map_data_to_params(data, api_info);
     let websocket;
-    let event_source;
+    let stream;
     let protocol = config.protocol ?? "ws";
     const _endpoint = typeof endpoint === "number" ? "/predict" : endpoint;
     let payload;
@@ -1080,14 +1148,14 @@ function submit(endpoint, data, event_data, trigger_id) {
         }
         cancel_request = { fn_index, session_hash };
       } else {
-        event_source == null ? void 0 : event_source.close();
+        stream == null ? void 0 : stream.close();
         cancel_request = { event_id };
       }
       try {
         if (!config) {
           throw new Error("Could not resolve app config");
         }
-        await fetch_implementation(`${config.root}/reset`, {
+        await fetch2(`${config.root}/reset`, {
           headers: { "Content-Type": "application/json" },
           method: "POST",
           body: JSON.stringify(cancel_request)
@@ -1098,8 +1166,9 @@ function submit(endpoint, data, event_data, trigger_id) {
         );
       }
     }
-    this.handle_blob(`${config.root}`, data, endpoint_info).then(
+    this.handle_blob(config.root, resolved_data, endpoint_info).then(
       async (_payload) => {
+        var _a;
         payload = {
           data: _payload || [],
           event_data,
@@ -1291,13 +1360,16 @@ function submit(endpoint, data, event_data, trigger_id) {
           let url = new URL(
             `${config.root}/queue/join?${url_params ? url_params + "&" : ""}${params}`
           );
-          event_source = this.eventSource_factory(url);
-          if (!event_source) {
-            throw new Error(
-              "Cannot connect to sse endpoint: " + url.toString()
+          if (this.jwt) {
+            url.searchParams.set("__sign", this.jwt);
+          }
+          stream = await this.stream(url);
+          if (!stream) {
+            return Promise.reject(
+              new Error("Cannot connect to SSE endpoint: " + url.toString())
             );
           }
-          event_source.onmessage = async function(event) {
+          stream.onmessage = async function(event) {
             const _data = JSON.parse(event.data);
             const { type, status, data: data2 } = handle_message(
               _data,
@@ -1312,7 +1384,7 @@ function submit(endpoint, data, event_data, trigger_id) {
                 ...status
               });
               if (status.stage === "error") {
-                event_source == null ? void 0 : event_source.close();
+                stream == null ? void 0 : stream.close();
               }
             } else if (type === "data") {
               event_id = _data.event_id;
@@ -1331,7 +1403,7 @@ function submit(endpoint, data, event_data, trigger_id) {
                   fn_index,
                   time: /* @__PURE__ */ new Date()
                 });
-                event_source == null ? void 0 : event_source.close();
+                stream == null ? void 0 : stream.close();
               }
             } else if (type === "complete") {
               complete = status;
@@ -1374,7 +1446,7 @@ function submit(endpoint, data, event_data, trigger_id) {
                   endpoint: _endpoint,
                   fn_index
                 });
-                event_source == null ? void 0 : event_source.close();
+                stream == null ? void 0 : stream.close();
               }
             }
           };
@@ -1387,7 +1459,10 @@ function submit(endpoint, data, event_data, trigger_id) {
             fn_index,
             time: /* @__PURE__ */ new Date()
           });
-          let hostname = window.location.hostname;
+          let hostname = "";
+          if (typeof window !== "undefined") {
+            hostname = (_a = window == null ? void 0 : window.location) == null ? void 0 : _a.hostname;
+          }
           let hfhubdev = "dev.spaces.huggingface.tech";
           const origin = hostname.includes(".dev.") ? `https://moon-${hostname.split(".")[1]}.${hfhubdev}` : `https://huggingface.co`;
           const zerogpu_auth_promise = dependency.zerogpu && window.parent != window && config.space_id ? post_message("zerogpu-headers", origin) : Promise.resolve(null);
@@ -1401,7 +1476,7 @@ function submit(endpoint, data, event_data, trigger_id) {
               headers
             );
           });
-          post_data_promise.then(([response, status]) => {
+          post_data_promise.then(async ([response, status]) => {
             if (status === 503) {
               fire_event({
                 type: "status",
@@ -1485,6 +1560,14 @@ function submit(endpoint, data, event_data, trigger_id) {
                       endpoint: _endpoint,
                       fn_index
                     });
+                    if (data2.render_config) {
+                      fire_event({
+                        type: "render",
+                        data: data2.render_config,
+                        endpoint: _endpoint,
+                        fn_index
+                      });
+                    }
                     if (complete) {
                       fire_event({
                         type: "status",
@@ -1517,7 +1600,7 @@ function submit(endpoint, data, event_data, trigger_id) {
                     time: /* @__PURE__ */ new Date()
                   });
                   if (["sse_v2", "sse_v2.1"].includes(protocol)) {
-                    close_stream(stream_status, event_source);
+                    close_stream(stream_status, stream);
                     stream_status.open = false;
                   }
                 }
@@ -1531,7 +1614,7 @@ function submit(endpoint, data, event_data, trigger_id) {
               event_callbacks[event_id] = callback;
               unclosed_events.add(event_id);
               if (!stream_status.open) {
-                this.open_stream();
+                await this.open_stream();
               }
             }
           });
@@ -1589,6 +1672,7 @@ class Client {
     __publicField(this, "heartbeat_event", null);
     __publicField(this, "view_api");
     __publicField(this, "upload_files");
+    __publicField(this, "upload");
     __publicField(this, "handle_blob");
     __publicField(this, "post_data");
     __publicField(this, "submit");
@@ -1605,15 +1689,23 @@ class Client {
     this.predict = predict.bind(this);
     this.open_stream = open_stream.bind(this);
     this.resolve_config = resolve_config.bind(this);
+    this.upload = upload.bind(this);
   }
-  fetch_implementation(input, init) {
+  fetch(input, init) {
     return fetch(input, init);
   }
-  eventSource_factory(url) {
-    if (typeof window !== void 0 && typeof EventSource !== "undefined") {
+  async stream(url) {
+    if (typeof window === "undefined" || typeof EventSource === "undefined") {
+      try {
+        const EventSourceModule = await import("eventsource");
+        return new EventSourceModule.default(url.toString());
+      } catch (error) {
+        console.error("Failed to load EventSource module:", error);
+        throw error;
+      }
+    } else {
       return new EventSource(url.toString());
     }
-    return null;
   }
   async init() {
     var _a;
@@ -1626,11 +1718,11 @@ class Client {
       await this._resolve_config().then(async ({ config }) => {
         if (config) {
           this.config = config;
-          if (this.config) {
+          if (this.config && this.config.connect_heartbeat) {
             const heartbeat_url = new URL(
               `${this.config.root}/heartbeat/${this.session_hash}`
             );
-            this.heartbeat_event = this.eventSource_factory(heartbeat_url);
+            this.heartbeat_event = await this.stream(heartbeat_url);
             if (this.config.space_id && this.options.hf_token) {
               this.jwt = await get_jwt(
                 this.config.space_id,
@@ -1641,7 +1733,7 @@ class Client {
         }
       });
     } catch (e) {
-      throw Error(`Could not resolve config: ${e}`);
+      throw Error(CONFIG_ERROR_MSG + e.message);
     }
     this.api_info = await this.view_api();
     this.api_map = map_names_to_ids(((_a = this.config) == null ? void 0 : _a.dependencies) || []);
@@ -1668,7 +1760,7 @@ class Client {
     try {
       config = await this.resolve_config(`${http_protocol}//${host}`);
       if (!config) {
-        throw new Error("Could not resolve app config");
+        throw new Error(CONFIG_ERROR_MSG);
       }
       return this.config_success(config);
     } catch (e) {
@@ -1703,7 +1795,7 @@ class Client {
     try {
       this.api_info = await this.view_api();
     } catch (e) {
-      console.error(`Could not get API details: ${e.message}`);
+      console.error(API_INFO_ERROR_MSG + e.message);
     }
     return this.prepare_return_obj();
   }
@@ -1715,7 +1807,7 @@ class Client {
       try {
         this.config = await this._resolve_config();
         if (!this.config) {
-          throw new Error("Could not resolve app config");
+          throw new Error(CONFIG_ERROR_MSG);
         }
         const _config = await this.config_success(this.config);
         return _config;
@@ -1735,7 +1827,7 @@ class Client {
   async component_server(component_id, fn_name, data) {
     var _a;
     if (!this.config) {
-      throw new Error("Could not resolve app config");
+      throw new Error(CONFIG_ERROR_MSG);
     }
     const headers = {};
     const { hf_token } = this.options;
@@ -1776,14 +1868,11 @@ class Client {
       headers.Authorization = `Bearer ${hf_token}`;
     }
     try {
-      const response = await this.fetch_implementation(
-        `${root_url}/component_server/`,
-        {
-          method: "POST",
-          body,
-          headers
-        }
-      );
+      const response = await this.fetch(`${root_url}/component_server/`, {
+        method: "POST",
+        body,
+        headers
+      });
       if (!response.ok) {
         throw new Error(
           "Could not connect to component server: " + response.statusText
@@ -1808,11 +1897,14 @@ class Client {
 async function client(app_reference, options = {}) {
   return await Client.connect(app_reference, options);
 }
+async function duplicate_space(app_reference, options) {
+  return await Client.duplicate(app_reference, options);
+}
 export {
   Client,
   FileData,
   client,
-  duplicate,
+  duplicate_space as duplicate,
   predict,
   prepare_files,
   submit,