@gradio/client 0.1.2 → 0.1.4

package/src/client.ts

@@ -45,7 +45,7 @@ type client_return = {
 		data?: unknown[],
 		event_data?: unknown
 	) => SubmitReturn;
-	view_api: (c?: Config) => Promise<Record<string, any>>;
+	view_api: (c?: Config) => Promise<ApiInfo<JsApiData>>;
 };
 
 type SubmitReturn = {
@@ -58,62 +58,8 @@ type SubmitReturn = {
 const QUEUE_FULL_MSG = "This application is too busy. Keep trying!";
 const BROKEN_CONNECTION_MSG = "Connection errored out.";
 
-export async function post_data(
-	url: string,
-	body: unknown,
-	token?: `hf_${string}`
-): Promise<[PostResponse, number]> {
-	const headers: {
-		Authorization?: string;
-		"Content-Type": "application/json";
-	} = { "Content-Type": "application/json" };
-	if (token) {
-		headers.Authorization = `Bearer ${token}`;
-	}
-	try {
-		var response = await fetch(url, {
-			method: "POST",
-			body: JSON.stringify(body),
-			headers
-		});
-	} catch (e) {
-		return [{ error: BROKEN_CONNECTION_MSG }, 500];
-	}
-	const output: PostResponse = await response.json();
-	return [output, response.status];
-}
-
 export let NodeBlob;
 
-export async function upload_files(
-	root: string,
-	files: Array<File>,
-	token?: `hf_${string}`
-): Promise<UploadResponse> {
-	const headers: {
-		Authorization?: string;
-	} = {};
-	if (token) {
-		headers.Authorization = `Bearer ${token}`;
-	}
-
-	const formData = new FormData();
-	files.forEach((file) => {
-		formData.append("files", file);
-	});
-	try {
-		var response = await fetch(`${root}/upload`, {
-			method: "POST",
-			body: formData,
-			headers
-		});
-	} catch (e) {
-		return { error: BROKEN_CONNECTION_MSG };
-	}
-	const output: UploadResponse["files"] = await response.json();
-	return { files: output };
-}
-
 export async function duplicate(
 	app_reference: string,
 	options: {
@@ -197,453 +143,526 @@ export async function duplicate(
 	}
 }
 
-export async function client(
-	app_reference: string,
-	options: {
-		hf_token?: `hf_${string}`;
-		status_callback?: SpaceStatusCallback;
-		normalise_files?: boolean;
-	} = { normalise_files: true }
-): Promise<client_return> {
-	return new Promise(async (res) => {
-		const { status_callback, hf_token, normalise_files } = options;
-		const return_obj = {
-			predict,
-			submit,
-			view_api
-			// duplicate
-		};
+/**
+ * We need to inject a customized fetch implementation for the Wasm version.
+ */
+export function api_factory(fetch_implementation: typeof fetch) {
+	return { post_data, upload_files, client, handle_blob };
+
+	async function post_data(
+		url: string,
+		body: unknown,
+		token?: `hf_${string}`
+	): Promise<[PostResponse, number]> {
+		const headers: {
+			Authorization?: string;
+			"Content-Type": "application/json";
+		} = { "Content-Type": "application/json" };
+		if (token) {
+			headers.Authorization = `Bearer ${token}`;
+		}
+		try {
+			var response = await fetch_implementation(url, {
+				method: "POST",
+				body: JSON.stringify(body),
+				headers
+			});
+		} catch (e) {
+			return [{ error: BROKEN_CONNECTION_MSG }, 500];
+		}
+		const output: PostResponse = await response.json();
+		return [output, response.status];
+	}
 
-		let transform_files = normalise_files ?? true;
-		if (typeof window === "undefined" || !("WebSocket" in window)) {
-			const ws = await import("ws");
-			NodeBlob = (await import("node:buffer")).Blob;
-			//@ts-ignore
-			global.WebSocket = ws.WebSocket;
+	async function upload_files(
+		root: string,
+		files: Array<File>,
+		token?: `hf_${string}`
+	): Promise<UploadResponse> {
+		const headers: {
+			Authorization?: string;
+		} = {};
+		if (token) {
+			headers.Authorization = `Bearer ${token}`;
 		}
 
-		const { ws_protocol, http_protocol, host, space_id } =
-			await process_endpoint(app_reference, hf_token);
+		const formData = new FormData();
+		files.forEach((file) => {
+			formData.append("files", file);
+		});
+		try {
+			var response = await fetch_implementation(`${root}/upload`, {
+				method: "POST",
+				body: formData,
+				headers
+			});
+		} catch (e) {
+			return { error: BROKEN_CONNECTION_MSG };
+		}
+		const output: UploadResponse["files"] = await response.json();
+		return { files: output };
+	}
+
+	async function client(
+		app_reference: string,
+		options: {
+			hf_token?: `hf_${string}`;
+			status_callback?: SpaceStatusCallback;
+			normalise_files?: boolean;
+		} = { normalise_files: true }
+	): Promise<client_return> {
+		return new Promise(async (res) => {
+			const { status_callback, hf_token, normalise_files } = options;
+			const return_obj = {
+				predict,
+				submit,
+				view_api
+				// duplicate
+			};
 
-		const session_hash = Math.random().toString(36).substring(2);
-		const last_status: Record<string, Status["stage"]> = {};
-		let config: Config;
-		let api_map: Record<string, number> = {};
+			const transform_files = normalise_files ?? true;
+			if (typeof window === "undefined" || !("WebSocket" in window)) {
+				const ws = await import("ws");
+				NodeBlob = (await import("node:buffer")).Blob;
+				//@ts-ignore
+				global.WebSocket = ws.WebSocket;
+			}
 
-		let jwt: false | string = false;
+			const { ws_protocol, http_protocol, host, space_id } =
+				await process_endpoint(app_reference, hf_token);
 
-		if (hf_token && space_id) {
-			jwt = await get_jwt(space_id, hf_token);
-		}
+			const session_hash = Math.random().toString(36).substring(2);
+			const last_status: Record<string, Status["stage"]> = {};
+			let config: Config;
+			let api_map: Record<string, number> = {};
 
-		async function config_success(_config: Config) {
-			config = _config;
-			api_map = map_names_to_ids(_config?.dependencies || []);
-			try {
-				api = await view_api(config);
-			} catch (e) {
-				console.error(`Could not get api details: ${e.message}`);
+			let jwt: false | string = false;
+
+			if (hf_token && space_id) {
+				jwt = await get_jwt(space_id, hf_token);
 			}
 
-			return {
-				config,
-				...return_obj
-			};
-		}
-		let api;
-		async function handle_space_sucess(status: SpaceStatus) {
-			if (status_callback) status_callback(status);
-			if (status.status === "running")
+			async function config_success(_config: Config) {
+				config = _config;
+				api_map = map_names_to_ids(_config?.dependencies || []);
 				try {
-					config = await resolve_config(`${http_protocol}//${host}`, hf_token);
-
-					const _config = await config_success(config);
-					res(_config);
+					api = await view_api(config);
 				} catch (e) {
-					if (status_callback) {
-						status_callback({
-							status: "error",
-							message: "Could not load this space.",
-							load_status: "error",
-							detail: "NOT_FOUND"
-						});
-					}
+					console.error(`Could not get api details: ${e.message}`);
 				}
-		}
-
-		try {
-			config = await resolve_config(`${http_protocol}//${host}`, hf_token);
 
-			const _config = await config_success(config);
-			res(_config);
-		} catch (e) {
-			if (space_id) {
-				check_space_status(
-					space_id,
-					RE_SPACE_NAME.test(space_id) ? "space_name" : "subdomain",
-					handle_space_sucess
-				);
-			} else {
-				if (status_callback)
-					status_callback({
-						status: "error",
-						message: "Could not load this space.",
-						load_status: "error",
-						detail: "NOT_FOUND"
-					});
+				return {
+					config,
+					...return_obj
+				};
 			}
-		}
+			let api: ApiInfo<JsApiData>;
+			async function handle_space_sucess(status: SpaceStatus) {
+				if (status_callback) status_callback(status);
+				if (status.status === "running")
+					try {
+						config = await resolve_config(
+							fetch_implementation,
+							`${http_protocol}//${host}`,
+							hf_token
+						);
 
-		/**
-		 * Run a prediction.
-		 * @param endpoint - The prediction endpoint to use.
-		 * @param status_callback - A function that is called with the current status of the prediction immediately and every time it updates.
-		 * @return Returns the data for the prediction or an error message.
-		 */
-		function predict(endpoint: string, data: unknown[], event_data?: unknown) {
-			let data_returned = false;
-			let status_complete = false;
-			return new Promise((res, rej) => {
-				const app = submit(endpoint, data, event_data);
-
-				app
-					.on("data", (d) => {
-						data_returned = true;
-						if (status_complete) {
-							app.destroy();
-						}
-						res(d);
-					})
-					.on("status", (status) => {
-						if (status.stage === "error") rej(status);
-						if (status.stage === "complete" && data_returned) {
-							app.destroy();
-						}
-						if (status.stage === "complete") {
-							status_complete = true;
+						const _config = await config_success(config);
+						res(_config);
+					} catch (e) {
+						console.error(e);
+						if (status_callback) {
+							status_callback({
+								status: "error",
+								message: "Could not load this space.",
+								load_status: "error",
+								detail: "NOT_FOUND"
+							});
 						}
-					});
-			});
-		}
+					}
+			}
 
-		function submit(
-			endpoint: string | number,
-			data: unknown[],
-			event_data?: unknown
-		): SubmitReturn {
-			let fn_index: number;
-			let api_info;
-
-			if (typeof endpoint === "number") {
-				fn_index = endpoint;
-				api_info = api.unnamed_endpoints[fn_index];
-			} else {
-				const trimmed_endpoint = endpoint.replace(/^\//, "");
+			try {
+				config = await resolve_config(
+					fetch_implementation,
+					`${http_protocol}//${host}`,
+					hf_token
+				);
 
-				fn_index = api_map[trimmed_endpoint];
-				api_info = api.named_endpoints[endpoint.trim()];
+				const _config = await config_success(config);
+				res(_config);
+			} catch (e) {
+				console.error(e);
+				if (space_id) {
+					check_space_status(
+						space_id,
+						RE_SPACE_NAME.test(space_id) ? "space_name" : "subdomain",
+						handle_space_sucess
+					);
+				} else {
+					if (status_callback)
+						status_callback({
+							status: "error",
+							message: "Could not load this space.",
+							load_status: "error",
+							detail: "NOT_FOUND"
+						});
+				}
 			}
 
-			if (typeof fn_index !== "number") {
-				throw new Error(
-					"There is no endpoint matching that name of fn_index matching that number."
-				);
+			/**
+			 * Run a prediction.
+			 * @param endpoint - The prediction endpoint to use.
+			 * @param status_callback - A function that is called with the current status of the prediction immediately and every time it updates.
+			 * @return Returns the data for the prediction or an error message.
+			 */
+			function predict(
+				endpoint: string,
+				data: unknown[],
+				event_data?: unknown
+			) {
+				let data_returned = false;
+				let status_complete = false;
+				return new Promise((res, rej) => {
+					const app = submit(endpoint, data, event_data);
+
+					app
+						.on("data", (d) => {
+							data_returned = true;
+							if (status_complete) {
+								app.destroy();
+							}
+							res(d);
+						})
+						.on("status", (status) => {
+							if (status.stage === "error") rej(status);
+							if (status.stage === "complete" && data_returned) {
+								app.destroy();
+							}
+							if (status.stage === "complete") {
+								status_complete = true;
+							}
+						});
+				});
 			}
 
-			let websocket: WebSocket;
+			function submit(
+				endpoint: string | number,
+				data: unknown[],
+				event_data?: unknown
+			): SubmitReturn {
+				let fn_index: number;
+				let api_info;
+
+				if (typeof endpoint === "number") {
+					fn_index = endpoint;
+					api_info = api.unnamed_endpoints[fn_index];
+				} else {
+					const trimmed_endpoint = endpoint.replace(/^\//, "");
 
-			const _endpoint = typeof endpoint === "number" ? "/predict" : endpoint;
-			let payload: Payload;
-			let complete: false | Record<string, any> = false;
-			const listener_map: ListenerMap<EventType> = {};
+					fn_index = api_map[trimmed_endpoint];
+					api_info = api.named_endpoints[endpoint.trim()];
+				}
 
-			//@ts-ignore
-			handle_blob(
-				`${http_protocol}//${host + config.path}`,
-				data,
-				api_info,
-				hf_token
-			).then((_payload) => {
-				payload = { data: _payload || [], event_data, fn_index };
-				if (skip_queue(fn_index, config)) {
-					fire_event({
-						type: "status",
-						endpoint: _endpoint,
-						stage: "pending",
-						queue: false,
-						fn_index,
-						time: new Date()
-					});
+				if (typeof fn_index !== "number") {
+					throw new Error(
+						"There is no endpoint matching that name of fn_index matching that number."
+					);
+				}
 
-					post_data(
-						`${http_protocol}//${host + config.path}/run${
-							_endpoint.startsWith("/") ? _endpoint : `/${_endpoint}`
-						}`,
-						{
-							...payload,
-							session_hash
-						},
-						hf_token
-					)
-						.then(([output, status_code]) => {
-							const data = transform_files
-								? transform_output(
-										output.data,
-										api_info,
-										config.root,
-										config.root_url
-								  )
-								: output.data;
-							if (status_code == 200) {
-								fire_event({
-									type: "data",
-									endpoint: _endpoint,
-									fn_index,
-									data: data,
-									time: new Date()
-								});
+				let websocket: WebSocket;
+
+				const _endpoint = typeof endpoint === "number" ? "/predict" : endpoint;
+				let payload: Payload;
+				let complete: false | Record<string, any> = false;
+				const listener_map: ListenerMap<EventType> = {};
+
+				handle_blob(
+					`${http_protocol}//${host + config.path}`,
+					data,
+					api_info,
+					hf_token
+				).then((_payload) => {
+					payload = { data: _payload || [], event_data, fn_index };
+					if (skip_queue(fn_index, config)) {
+						fire_event({
+							type: "status",
+							endpoint: _endpoint,
+							stage: "pending",
+							queue: false,
+							fn_index,
+							time: new Date()
+						});
 
-								fire_event({
-									type: "status",
-									endpoint: _endpoint,
-									fn_index,
-									stage: "complete",
-									eta: output.average_duration,
-									queue: false,
-									time: new Date()
-								});
-							} else {
+						post_data(
+							`${http_protocol}//${host + config.path}/run${
+								_endpoint.startsWith("/") ? _endpoint : `/${_endpoint}`
+							}`,
+							{
+								...payload,
+								session_hash
+							},
+							hf_token
+						)
+							.then(([output, status_code]) => {
+								const data = transform_files
+									? transform_output(
+											output.data,
+											api_info,
+											config.root,
+											config.root_url
+									  )
+									: output.data;
+								if (status_code == 200) {
+									fire_event({
+										type: "data",
+										endpoint: _endpoint,
+										fn_index,
+										data: data,
+										time: new Date()
+									});
+
+									fire_event({
+										type: "status",
+										endpoint: _endpoint,
+										fn_index,
+										stage: "complete",
+										eta: output.average_duration,
+										queue: false,
+										time: new Date()
+									});
+								} else {
+									fire_event({
+										type: "status",
+										stage: "error",
+										endpoint: _endpoint,
+										fn_index,
+										message: output.error,
+										queue: false,
+										time: new Date()
+									});
+								}
+							})
+							.catch((e) => {
 								fire_event({
 									type: "status",
 									stage: "error",
+									message: e.message,
 									endpoint: _endpoint,
 									fn_index,
-									message: output.error,
 									queue: false,
 									time: new Date()
 								});
-							}
-						})
-						.catch((e) => {
-							fire_event({
-								type: "status",
-								stage: "error",
-								message: e.message,
-								endpoint: _endpoint,
-								fn_index,
-								queue: false,
-								time: new Date()
 							});
+					} else {
+						fire_event({
+							type: "status",
+							stage: "pending",
+							queue: true,
+							endpoint: _endpoint,
+							fn_index,
+							time: new Date()
 						});
-				} else {
-					fire_event({
-						type: "status",
-						stage: "pending",
-						queue: true,
-						endpoint: _endpoint,
-						fn_index,
-						time: new Date()
-					});
-
-					let url = new URL(`${ws_protocol}://${host}${config.path}
-						/queue/join`);
 
-					if (jwt) {
-						url.searchParams.set("__sign", jwt);
-					}
+						let url = new URL(`${ws_protocol}://${host}${config.path}
+							/queue/join`);
 
-					websocket = new WebSocket(url);
-
-					websocket.onclose = (evt) => {
-						if (!evt.wasClean) {
-							fire_event({
-								type: "status",
-								stage: "error",
-								message: BROKEN_CONNECTION_MSG,
-								queue: true,
-								endpoint: _endpoint,
-								fn_index,
-								time: new Date()
-							});
+						if (jwt) {
+							url.searchParams.set("__sign", jwt);
 						}
-					};
 
-					websocket.onmessage = function (event) {
-						const _data = JSON.parse(event.data);
-						const { type, status, data } = handle_message(
-							_data,
-							last_status[fn_index]
-						);
+						websocket = new WebSocket(url);
 
-						if (type === "update" && status && !complete) {
-							// call 'status' listeners
-							fire_event({
-								type: "status",
-								endpoint: _endpoint,
-								fn_index,
-								time: new Date(),
-								...status
-							});
-							if (status.stage === "error") {
-								websocket.close();
+						websocket.onclose = (evt) => {
+							if (!evt.wasClean) {
+								fire_event({
+									type: "status",
+									stage: "error",
+									message: BROKEN_CONNECTION_MSG,
+									queue: true,
+									endpoint: _endpoint,
+									fn_index,
+									time: new Date()
+								});
 							}
-						} else if (type === "hash") {
-							websocket.send(JSON.stringify({ fn_index, session_hash }));
-							return;
-						} else if (type === "data") {
-							websocket.send(JSON.stringify({ ...payload, session_hash }));
-						} else if (type === "complete") {
-							complete = status;
-						} else if (type === "generating") {
-							fire_event({
-								type: "status",
-								time: new Date(),
-								...status,
-								stage: status?.stage!,
-								queue: true,
-								endpoint: _endpoint,
-								fn_index
-							});
-						}
-						if (data) {
-							fire_event({
-								type: "data",
-								time: new Date(),
-								data: transform_files
-									? transform_output(
-											data.data,
-											api_info,
-											config.root,
-											config.root_url
-									  )
-									: data.data,
-								endpoint: _endpoint,
-								fn_index
-							});
+						};
+
+						websocket.onmessage = function (event) {
+							const _data = JSON.parse(event.data);
+							const { type, status, data } = handle_message(
+								_data,
+								last_status[fn_index]
+							);
 
-							if (complete) {
+							if (type === "update" && status && !complete) {
+								// call 'status' listeners
+								fire_event({
+									type: "status",
+									endpoint: _endpoint,
+									fn_index,
+									time: new Date(),
+									...status
+								});
+								if (status.stage === "error") {
+									websocket.close();
+								}
+							} else if (type === "hash") {
+								websocket.send(JSON.stringify({ fn_index, session_hash }));
+								return;
+							} else if (type === "data") {
+								websocket.send(JSON.stringify({ ...payload, session_hash }));
+							} else if (type === "complete") {
+								complete = status;
+							} else if (type === "generating") {
 								fire_event({
 									type: "status",
 									time: new Date(),
-									...complete,
+									...status,
 									stage: status?.stage!,
 									queue: true,
 									endpoint: _endpoint,
 									fn_index
 								});
-								websocket.close();
 							}
-						}
-					};
+							if (data) {
+								fire_event({
+									type: "data",
+									time: new Date(),
+									data: transform_files
+										? transform_output(
+												data.data,
+												api_info,
+												config.root,
+												config.root_url
+										  )
+										: data.data,
+									endpoint: _endpoint,
+									fn_index
+								});
 
-					// different ws contract for gradio versions older than 3.6.0
-					//@ts-ignore
-					if (semiver(config.version || "2.0.0", "3.6") < 0) {
-						addEventListener("open", () =>
-							websocket.send(JSON.stringify({ hash: session_hash }))
-						);
+								if (complete) {
+									fire_event({
+										type: "status",
+										time: new Date(),
+										...complete,
+										stage: status?.stage!,
+										queue: true,
+										endpoint: _endpoint,
+										fn_index
+									});
+									websocket.close();
+								}
+							}
+						};
+
+						// different ws contract for gradio versions older than 3.6.0
+						//@ts-ignore
+						if (semiver(config.version || "2.0.0", "3.6") < 0) {
+							addEventListener("open", () =>
+								websocket.send(JSON.stringify({ hash: session_hash }))
+							);
+						}
 					}
-				}
-			});
+				});
 
-			function fire_event<K extends EventType>(event: Event<K>) {
-				const narrowed_listener_map: ListenerMap<K> = listener_map;
-				let listeners = narrowed_listener_map[event.type] || [];
-				listeners?.forEach((l) => l(event));
-			}
+				function fire_event<K extends EventType>(event: Event<K>) {
+					const narrowed_listener_map: ListenerMap<K> = listener_map;
+					const listeners = narrowed_listener_map[event.type] || [];
+					listeners?.forEach((l) => l(event));
+				}
 
-			function on<K extends EventType>(
-				eventType: K,
-				listener: EventListener<K>
-			) {
-				const narrowed_listener_map: ListenerMap<K> = listener_map;
-				let listeners = narrowed_listener_map[eventType] || [];
-				narrowed_listener_map[eventType] = listeners;
-				listeners?.push(listener);
+				function on<K extends EventType>(
+					eventType: K,
+					listener: EventListener<K>
+				) {
+					const narrowed_listener_map: ListenerMap<K> = listener_map;
+					const listeners = narrowed_listener_map[eventType] || [];
+					narrowed_listener_map[eventType] = listeners;
+					listeners?.push(listener);
 
-				return { on, off, cancel, destroy };
-			}
+					return { on, off, cancel, destroy };
+				}
 
-			function off<K extends EventType>(
-				eventType: K,
-				listener: EventListener<K>
-			) {
-				const narrowed_listener_map: ListenerMap<K> = listener_map;
-				let listeners = narrowed_listener_map[eventType] || [];
-				listeners = listeners?.filter((l) => l !== listener);
-				narrowed_listener_map[eventType] = listeners;
+				function off<K extends EventType>(
+					eventType: K,
+					listener: EventListener<K>
+				) {
+					const narrowed_listener_map: ListenerMap<K> = listener_map;
+					let listeners = narrowed_listener_map[eventType] || [];
+					listeners = listeners?.filter((l) => l !== listener);
+					narrowed_listener_map[eventType] = listeners;
 
-				return { on, off, cancel, destroy };
-			}
+					return { on, off, cancel, destroy };
+				}
 
-			async function cancel() {
-				const _status: Status = {
-					stage: "complete",
-					queue: false,
-					time: new Date()
-				};
-				complete = _status;
-				fire_event({
-					..._status,
-					type: "status",
-					endpoint: _endpoint,
-					fn_index: fn_index
-				});
+				async function cancel() {
+					const _status: Status = {
+						stage: "complete",
+						queue: false,
+						time: new Date()
+					};
+					complete = _status;
+					fire_event({
+						..._status,
+						type: "status",
+						endpoint: _endpoint,
+						fn_index: fn_index
+					});
 
-				if (websocket && websocket.readyState === 0) {
-					websocket.addEventListener("open", () => {
+					if (websocket && websocket.readyState === 0) {
+						websocket.addEventListener("open", () => {
+							websocket.close();
+						});
+					} else {
 						websocket.close();
-					});
-				} else {
-					websocket.close();
-				}
+					}
 
-				try {
-					await fetch(`${http_protocol}//${host + config.path}/reset`, {
-						headers: { "Content-Type": "application/json" },
-						method: "POST",
-						body: JSON.stringify({ fn_index, session_hash })
-					});
-				} catch (e) {
-					console.warn(
-						"The `/reset` endpoint could not be called. Subsequent endpoint results may be unreliable."
-					);
+					try {
+						await fetch_implementation(
+							`${http_protocol}//${host + config.path}/reset`,
+							{
+								headers: { "Content-Type": "application/json" },
+								method: "POST",
+								body: JSON.stringify({ fn_index, session_hash })
+							}
+						);
+					} catch (e) {
+						console.warn(
+							"The `/reset` endpoint could not be called. Subsequent endpoint results may be unreliable."
+						);
+					}
 				}
-			}
 
-			function destroy() {
-				for (const event_type in listener_map) {
-					listener_map[event_type as "data" | "status"].forEach((fn) => {
-						off(event_type as "data" | "status", fn);
-					});
+				function destroy() {
+					for (const event_type in listener_map) {
+						listener_map[event_type as "data" | "status"].forEach((fn) => {
+							off(event_type as "data" | "status", fn);
+						});
+					}
 				}
+
+				return {
+					on,
+					off,
+					cancel,
+					destroy
+				};
 			}
 
-			return {
-				on,
-				off,
-				cancel,
-				destroy
-			};
-		}
+			async function view_api(config?: Config): Promise<ApiInfo<JsApiData>> {
+				if (api) return api;
 
-		async function view_api(
-			config?: Config
-		): Promise<ApiInfo<JsApiData> | [{ error: string }, 500]> {
-			if (api) return api;
-
-			const headers: {
-				Authorization?: string;
-				"Content-Type": "application/json";
-			} = { "Content-Type": "application/json" };
-			if (hf_token) {
-				headers.Authorization = `Bearer ${hf_token}`;
-			}
-			try {
+				const headers: {
+					Authorization?: string;
+					"Content-Type": "application/json";
+				} = { "Content-Type": "application/json" };
+				if (hf_token) {
+					headers.Authorization = `Bearer ${hf_token}`;
+				}
 				let response: Response;
 				// @ts-ignore
 				if (semiver(config.version || "2.0.0", "3.30") < 0) {
-					response = await fetch(
+					response = await fetch_implementation(
 						"https://gradio-space-api-fetcher-v2.hf.space/api",
 						{
 							method: "POST",
@@ -655,11 +674,15 @@ export async function client(
 						}
 					);
 				} else {
-					response = await fetch(`${config.root}/info`, {
+					response = await fetch_implementation(`${config.root}/info`, {
 						headers
 					});
 				}
 
+				if (!response.ok) {
+					throw new Error(BROKEN_CONNECTION_MSG);
+				}
+
 				let api_info = (await response.json()) as
 					| ApiInfo<ApiData>
 					| { api: ApiInfo<ApiData> };
@@ -676,20 +699,66 @@ export async function client(
 
 				const x = transform_api_info(api_info, config, api_map);
 				return x;
-			} catch (e) {
-				return [{ error: BROKEN_CONNECTION_MSG }, 500];
 			}
-		}
-	});
+		});
+	}
+
+	async function handle_blob(
+		endpoint: string,
+		data: unknown[],
+		api_info,
+		token?: `hf_${string}`
+	): Promise<unknown[]> {
+		const blob_refs = await walk_and_store_blobs(
+			data,
+			undefined,
+			[],
+			true,
+			api_info
+		);
+
+		return Promise.all(
+			blob_refs.map(async ({ path, blob, data, type }) => {
+				if (blob) {
+					const file_url = (await upload_files(endpoint, [blob], token))
+						.files[0];
+					return { path, file_url, type };
+				} else {
+					return { path, base64: data, type };
+				}
+			})
+		).then((r) => {
+			r.forEach(({ path, file_url, base64, type }) => {
+				if (base64) {
+					update_object(data, base64, path);
+				} else if (type === "Gallery") {
+					update_object(data, file_url, path);
+				} else if (file_url) {
+					const o = {
+						is_file: true,
+						name: `${file_url}`,
+						data: null
+						// orig_name: "file.csv"
+					};
+					update_object(data, o, path);
+				}
+			});
+
+			return data;
+		});
+	}
 }
 
+export const { post_data, upload_files, client, handle_blob } =
+	api_factory(fetch);
+
 function transform_output(
 	data: any[],
 	api_info: any,
 	root_url: string,
 	remote_url?: string
 ): unknown[] {
-	let transformed_data = data.map((d, i) => {
+	return data.map((d, i) => {
 		if (api_info.returns?.[i]?.component === "File") {
 			return normalise_file(d, root_url, remote_url);
 		} else if (api_info.returns?.[i]?.component === "Gallery") {
@@ -704,8 +773,6 @@ function transform_output(
 			return d;
 		}
 	});
-
-	return transformed_data;
 }
 
 function normalise_file(
@@ -750,7 +817,7 @@ function normalise_file(
 		if (!root_url) {
 			file.data = root + "/file=" + file.name;
 		} else {
-			file.data = "/proxy=" + root_url + "/file=" + file.name;
+			file.data = "/proxy=" + root_url + "file=" + file.name;
 		}
 	}
 	return file;
@@ -907,55 +974,6 @@ async function get_jwt(
 	}
 }
 
-export async function handle_blob(
-	endpoint: string,
-	data: unknown[],
-	api_info,
-	token?: `hf_${string}`
-): Promise<unknown[]> {
-	const blob_refs = await walk_and_store_blobs(
-		data,
-		undefined,
-		[],
-		true,
-		api_info
-	);
-
-	return new Promise((res) => {
-		Promise.all(
-			blob_refs.map(async ({ path, blob, data, type }) => {
-				if (blob) {
-					const file_url = (await upload_files(endpoint, [blob], token))
-						.files[0];
-					return { path, file_url, type };
-				} else {
-					return { path, base64: data, type };
-				}
-			})
-		)
-			.then((r) => {
-				r.forEach(({ path, file_url, base64, type }) => {
-					if (base64) {
-						update_object(data, base64, path);
-					} else if (type === "Gallery") {
-						update_object(data, file_url, path);
-					} else if (file_url) {
-						const o = {
-							is_file: true,
-							name: `${file_url}`,
-							data: null
-							// orig_name: "file.csv"
-						};
-						update_object(data, o, path);
-					}
-				});
-
-				res(data);
-			})
-			.catch(console.log);
-	});
-}
-
 function update_object(object, newValue, stack) {
 	while (stack.length > 1) {
 		object = object[stack.shift()];
@@ -1061,6 +1079,7 @@ function skip_queue(id: number, config: Config) {
 }
 
 async function resolve_config(
+	fetch_implementation: typeof fetch,
 	endpoint?: string,
 	token?: `hf_${string}`
 ): Promise<Config> {
@@ -1078,7 +1097,9 @@ async function resolve_config(
 		config.root = endpoint + config.root;
 		return { ...config, path: path };
 	} else if (endpoint) {
-		let response = await fetch(`${endpoint}/config`, { headers });
+		let response = await fetch_implementation(`${endpoint}/config`, {
+			headers
+		});
 
 		if (response.status === 200) {
 			const config = await response.json();
@@ -1139,9 +1160,18 @@ async function check_space_status(
 
 			setTimeout(() => {
 				check_space_status(id, type, status_callback);
-			}, 1000);
+			}, 1000); // poll for status
+			break;
+		case "PAUSED":
+			status_callback({
+				status: "paused",
+				load_status: "error",
+				message:
+					"This space has been paused by the author. If you would like to try this demo, consider duplicating the space.",
+				detail: stage,
+				discussions_enabled: await discussions_enabled(space_name)
+			});
 			break;
-		// poll for status
 		case "RUNNING":
 		case "RUNNING_BUILDING":
 			status_callback({