@gradio/client 2.5.1 → 2.7.0

package/dist/types.d.ts

@@ -281,11 +281,11 @@ export interface ClientOptions {
      */
     oauth_token?: string;
     /**
-     * Whether to save each call's inputs and outputs in this browser's local
-     * storage, so they can be reviewed on the app's run history page. Defaults
-     * to true, and only ever applies in a browser: in Node there is no storage
-     * to write to and nothing is recorded. The app can turn it off for everyone
-     * with `run_history=False` on `launch()`, which takes precedence over this.
+     * Whether to save each call's inputs and outputs to the history destination
+     * selected in this browser (local storage by default, or a connected bucket).
+     * Defaults to true, and only ever applies in a browser: in Node there is no
+     * selected destination and nothing is recorded. The app can turn it off for
+     * everyone with `run_history=False` on `launch()`, which takes precedence.
      */
     record_history?: boolean;
 }

package/dist/upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,wBAAsB,MAAM,CAC3B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CAsCrC;AAED,wBAAsB,aAAa,CAClC,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,CAAC,EAAE,OAAO,GACjB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAYrB;AAED,qBAAa,QAAQ;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,IAAI;;MAAgC;gBAEjC,EACX,IAAI,EACJ,GAAG,EACH,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,SAAS,EACT,QAAQ,EACR,GAAG,EACH,EAAE;QACF,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,IAAI,CAAC;QACZ,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;KACb;CAWD"}
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,wBAAsB,MAAM,CAC3B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CA0CrC;AAED,wBAAsB,aAAa,CAClC,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,CAAC,EAAE,OAAO,GACjB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAYrB;AAED,qBAAa,QAAQ;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,IAAI;;MAAgC;gBAEjC,EACX,IAAI,EACJ,GAAG,EACH,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,SAAS,EACT,QAAQ,EACR,GAAG,EACH,EAAE;QACF,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,IAAI,CAAC;QACZ,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;KACb;CAWD"}

package/dist/utils/bucket_sync.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Client for the durable run history in an HF Hub bucket
+ * (`/gradio_api/run-history/*`).
+ *
+ * Read-only by design. Records are written by the server from the run it
+ * actually executed — there is no push function here, and nothing in this
+ * module can create a record.
+ *
+ * Every call names the bucket it is talking about. The server holds no
+ * per-session binding, so two tabs (or two apps on one origin) cannot end up
+ * reading each other's history.
+ */
+export declare function is_valid_bucket_id(id: string): boolean;
+/** Mirrors `HistoryRecord` in `gradio/history.py`. */
+export interface HistoryRecord {
+    record_id: string;
+    endpoint: string;
+    inputs: unknown;
+    outputs: unknown;
+    started_at: string;
+    schema_version: number;
+}
+export interface HistoryResult<T> {
+    ok: boolean;
+    status: number;
+    data: T;
+    detail?: string;
+}
+/**
+ * Create the bucket if it does not exist and confirm it is writable. Stores
+ * nothing server-side — the caller keeps its own choice and names it on every
+ * later request.
+ */
+export declare function connect_bucket(root: string, bucket_id: string): Promise<HistoryResult<null>>;
+export declare function list_user_buckets(root: string): Promise<HistoryResult<string[]>>;
+export declare function list_bucket_records(root: string, bucket: string): Promise<HistoryResult<HistoryRecord[]>>;
+export declare function asset_url(root: string, bucket: string, endpoint: string, record_id: string, filename: string): string;
+//# sourceMappingURL=bucket_sync.d.ts.map

package/dist/utils/bucket_sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bucket_sync.d.ts","sourceRoot":"","sources":["../../src/utils/bucket_sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAKtD;AAED,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAuDD;;;;GAIG;AACH,wBAAsB,cAAc,CACnC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAmB9B;AAED,wBAAsB,iBAAiB,CACtC,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAIlC;AAED,wBAAsB,mBAAmB,CACxC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,CAAC,aAAa,EAAE,CAAC,CAAC,CAIzC;AAED,wBAAgB,SAAS,CACxB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACd,MAAM,CAQR"}

package/dist/utils/run_history.d.ts

@@ -9,6 +9,13 @@ export interface RunHistoryScope {
     /** The authenticated user, when the app uses `auth`. */
     username?: string | null;
 }
+export type RunHistoryStorage = {
+    type: "browser";
+    bucket_id?: string;
+} | {
+    type: "bucket";
+    bucket_id: string;
+};
 export type RunStatus = "running" | "completed" | "failed";
 export interface StoredRunComponent {
     type: string;
@@ -70,6 +77,8 @@ export interface ReplayTarget {
     }[];
 }
 export declare function read_run_history(scope: RunHistoryScope | null | undefined): StoredRun[];
+export declare function read_run_history_storage(scope: RunHistoryScope | null | undefined): RunHistoryStorage;
+export declare function set_run_history_storage(scope: RunHistoryScope | null | undefined, storage: RunHistoryStorage): void;
 export declare function clear_run_history(scope: RunHistoryScope | null | undefined): void;
 export declare function delete_run_history(scope: RunHistoryScope | null | undefined, id: string): void;
 export declare function stage_run_history_replay(scope: RunHistoryScope | null | undefined, run: StoredRun): void;

package/dist/utils/run_history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run_history.d.ts","sourceRoot":"","sources":["../../src/utils/run_history.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run_history.d.ts","sourceRoot":"","sources":["../../src/utils/run_history.ts"],"names":[],"mappings":"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"}

package/dist/utils/submit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"submit.d.ts","sourceRoot":"","sources":["../../src/utils/submit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGX,WAAW,EAMX,cAAc,EACd,MAAM,UAAU,CAAC;AAoBlB,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAOnC,wBAAgB,MAAM,CACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,IAAI,GAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAC9C,UAAU,CAAC,EAAE,OAAO,EACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,EAC1B,UAAU,CAAC,EAAE,OAAO,EACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACzC,cAAc,CAAC,WAAW,CAAC,CA8uB7B"}
+{"version":3,"file":"submit.d.ts","sourceRoot":"","sources":["../../src/utils/submit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGX,WAAW,EAMX,cAAc,EACd,MAAM,UAAU,CAAC;AAyBlB,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAQnC,wBAAgB,MAAM,CACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,IAAI,GAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAC9C,UAAU,CAAC,EAAE,OAAO,EACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,EAC1B,UAAU,CAAC,EAAE,OAAO,EACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACzC,cAAc,CAAC,WAAW,CAAC,CA0vB7B"}

package/dist/utils/view_api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view_api.d.ts","sourceRoot":"","sources":["../../src/utils/view_api.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAInC,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAiDzD"}
+{"version":3,"file":"view_api.d.ts","sourceRoot":"","sources":["../../src/utils/view_api.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAInC,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAoDzD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradio/client",
-  "version": "2.5.1",
+  "version": "2.7.0",
   "description": "Gradio API client",
   "type": "module",
   "main": "dist/index.cjs",

package/src/client.ts

@@ -35,6 +35,7 @@ import { check_and_wake_space, check_space_status } from "./helpers/spaces";
 import { initialize_zerogpu_handshake } from "./helpers/zerogpu";
 import { open_stream, readable_stream, close_stream } from "./utils/stream";
 import { clear_run_history } from "./utils/run_history";
+import { sign_config_file_urls, sign_file_urls } from "./helpers/data";
 import {
 	API_INFO_ERROR_MSG,
 	APP_ID_URL,
@@ -48,6 +49,7 @@ export class Client {
 	app_reference: string;
 	options: ClientOptions;
 	deep_link: string | null = null;
+	page: string | null = null;
 
 	config: Config | undefined;
 	api_prefix = "";
@@ -199,6 +201,7 @@ export class Client {
 	) {
 		this.app_reference = app_reference;
 		this.deep_link = options.query_params?.deep_link || null;
+		this.page = options.query_params?.page ?? null;
 		if (!options.events) {
 			options.events = ["data"];
 		}
@@ -250,25 +253,19 @@ export class Client {
 	}
 
 	async _resolve_heartbeat(_config: Config): Promise<void> {
-		if (_config) {
-			this.config = _config;
-			this.api_prefix = _config.api_prefix || "";
-
-			if (this.config && this.config.connect_heartbeat) {
-				if (this.config.space_id && this.options.token) {
-					this.jwt = await get_jwt(
-						this.config.space_id,
-						this.options.token,
-						this.cookies
-					);
-				}
-			}
-		}
+		this.config = _config;
+		this.api_prefix = _config.api_prefix || "";
 
 		if (_config.space_id && this.options.token) {
-			this.jwt = await get_jwt(_config.space_id, this.options.token);
+			this.jwt = await get_jwt(
+				_config.space_id,
+				this.options.token,
+				this.cookies
+			);
 		}
 
+		sign_config_file_urls(this.config, this.jwt);
+
 		if (this.config && this.config.connect_heartbeat) {
 			// connect to the heartbeat endpoint via GET request
 			const heartbeat_url = new URL(
@@ -344,6 +341,7 @@ export class Client {
 		this.config = config;
 		this.api_prefix = config.api_prefix || "";
 		this.api_map = map_names_to_ids(config.dependencies || []);
+		sign_config_file_urls(this.config, this.jwt);
 		try {
 			this.api_info = await this.view_api();
 		} catch (e) {
@@ -545,6 +543,12 @@ export class Client {
 			}
 
 			const output = await response.json();
+			sign_file_urls(
+				output,
+				this.config.root,
+				this.config.api_prefix || "",
+				this.jwt
+			);
 			return output;
 		} catch (e) {
 			console.warn(e);

package/src/helpers/data.ts

@@ -224,3 +224,80 @@ export function handle_payload(
 
 	return updated_payload;
 }
+
+const FILE_ROUTE_PREFIXES = ["/file=", "/file/", "/stream/", "/proxy="];
+
+/**
+ * Add the Space JWT required for browser-managed media requests.
+ *
+ * This is a bearer credential and must not be logged or persisted. Restrict it
+ * to Gradio routes that serve files; the user's Hugging Face token remains in
+ * the Authorization header used to obtain this credential.
+ */
+export function sign_file_urls(
+	data: unknown,
+	root: string,
+	api_prefix: string,
+	jwt: string | false
+): void {
+	if (!jwt || data === null || typeof data !== "object") return;
+
+	const signature = jwt;
+	const root_url = new URL(root);
+	const root_path = root_url.pathname.replace(/\/+$/, "");
+	const normalized_api_prefix = api_prefix
+		? `/${api_prefix.replace(/^\/+|\/+$/g, "")}`
+		: "";
+	const route_bases = new Set([
+		`${root_path}${normalized_api_prefix}`,
+		normalized_api_prefix
+	]);
+	if (!normalized_api_prefix) {
+		route_bases.add(`${root_path}/gradio_api`);
+		route_bases.add("/gradio_api");
+	}
+
+	function visit(value: unknown): void {
+		if (value === null || typeof value !== "object") return;
+
+		const object = value as Record<string, unknown>;
+		const meta = object.meta as Record<string, unknown> | undefined;
+		if (meta?._type === "gradio.FileData" && typeof object.url === "string") {
+			const file_url = new URL(
+				object.url,
+				`${root_url.toString().replace(/\/$/, "")}/`
+			);
+			const is_file_route = [...route_bases].some((base) =>
+				FILE_ROUTE_PREFIXES.some((route) =>
+					file_url.pathname.startsWith(`${base}${route}`)
+				)
+			);
+			if (
+				(file_url.protocol === "http:" || file_url.protocol === "https:") &&
+				file_url.origin === root_url.origin &&
+				is_file_route
+			) {
+				file_url.searchParams.set("__sign", signature);
+				object.url = file_url.toString();
+			}
+		}
+
+		for (const child of Object.values(object)) visit(child);
+	}
+
+	visit(data);
+}
+
+export function sign_config_file_urls(
+	config: Config,
+	jwt: string | false
+): void {
+	for (const component of config.components || []) {
+		sign_file_urls(
+			component.props?.value,
+			config.root,
+			config.api_prefix || "",
+			jwt
+		);
+	}
+}

package/src/helpers/init_helpers.ts

@@ -83,10 +83,22 @@ export function map_names_to_ids(
 
 export function resolve_config_root(
 	root: string,
-	current_location: string
+	current_location: string,
+	prioritize_current_location = false
 ): string {
-	const root_url = new URL(root, current_location);
 	const current_url = new URL(current_location);
+	const root_url = new URL(root, current_url);
+	// Modern Colab configs can omit is_colab even though the backend root still
+	// uses one of Colab's internal-only hostname families.
+	const is_colab_runtime =
+		root_url.hostname.endsWith(".colab-user-runtimes.internal") ||
+		root_url.hostname.endsWith(".codatalab-user-runtimes.internal");
+	if (prioritize_current_location || is_colab_runtime) {
+		return new URL(new URL(root, current_url).pathname, current_url)
+			.toString()
+			.replace(/\/$/, "");
+	}
+
 	if (root_url.hostname !== current_url.hostname) {
 		return root;
 	}
@@ -117,12 +129,10 @@ export async function resolve_config(
 			window.gradio_config.dev_mode ||
 			(typeof window !== "undefined" && window?.BUILD_MODE === "dev")
 		) {
-			let config_url = join_urls(
-				endpoint,
-				this.deep_link
-					? CONFIG_URL + "?deep_link=" + this.deep_link
-					: CONFIG_URL
-			);
+			let config_url = new URL(join_urls(endpoint, CONFIG_URL));
+			if (this.deep_link)
+				config_url.searchParams.set("deep_link", this.deep_link);
+			if (this.page !== null) config_url.searchParams.set("page", this.page);
 			const response = await this.fetch(config_url, {
 				headers,
 				credentials: this.options.credentials ?? "same-origin"
@@ -138,15 +148,20 @@ export async function resolve_config(
 		// The page was rendered by this Gradio server, so a same-host root may
 		// contain an internal protocol or port supplied by a reverse proxy. Keep
 		// the configured path, but use the browser-visible origin for requests
-		// made by the client itself (queue, upload, reset, etc.).
+		// made by the client itself (queue, upload, reset, etc.). Colab's public
+		// proxy uses a different hostname, so always prefer the browser origin.
 		const config = { ...window.gradio_config } as unknown as Config;
-		config.root = resolve_config_root(config.root, location.href);
+		config.root = resolve_config_root(
+			config.root,
+			location.href,
+			config.is_colab
+		);
 		return config;
 	} else if (endpoint) {
-		let config_url = join_urls(
-			endpoint,
-			this.deep_link ? CONFIG_URL + "?deep_link=" + this.deep_link : CONFIG_URL
-		);
+		let config_url = new URL(join_urls(endpoint, CONFIG_URL));
+		if (this.deep_link)
+			config_url.searchParams.set("deep_link", this.deep_link);
+		if (this.page !== null) config_url.searchParams.set("page", this.page);
 
 		const response = await this.fetch(config_url, {
 			headers,

package/src/index.ts

@@ -12,13 +12,25 @@ export {
 	delete_run_history,
 	on_run_history_change,
 	read_run_history,
+	read_run_history_storage,
 	run_history_url,
+	set_run_history_storage,
 	stage_run_history_replay,
 	type ReplayTarget,
+	type RunHistoryStorage,
 	type RunHistoryScope,
 	type StoredRunComponent,
 	type StoredRun
 } from "./utils/run_history";
+export {
+	asset_url,
+	connect_bucket,
+	is_valid_bucket_id,
+	list_bucket_records,
+	list_user_buckets,
+	type HistoryRecord,
+	type HistoryResult
+} from "./utils/bucket_sync";
 
 export type {
 	SpaceStatus,

package/src/test/bucket_sync.test.ts

@@ -0,0 +1,138 @@
+import { describe, it, expect, vi, afterEach } from "vitest";
+import {
+	asset_url,
+	connect_bucket,
+	is_valid_bucket_id,
+	list_bucket_records,
+	list_user_buckets
+} from "../utils/bucket_sync";
+
+describe("is_valid_bucket_id", () => {
+	it("accepts user/name form", () => {
+		expect(is_valid_bucket_id("alice/my-history")).toBe(true);
+	});
+
+	it("rejects missing slash", () => {
+		expect(is_valid_bucket_id("alice")).toBe(false);
+	});
+
+	it("rejects path traversal", () => {
+		expect(is_valid_bucket_id("alice/..")).toBe(false);
+		expect(is_valid_bucket_id("../etc")).toBe(false);
+		expect(is_valid_bucket_id("alice/./x")).toBe(false);
+	});
+
+	it("rejects empty segments", () => {
+		expect(is_valid_bucket_id("alice/")).toBe(false);
+		expect(is_valid_bucket_id("/name")).toBe(false);
+	});
+});
+
+describe("list_bucket_records", () => {
+	const orig = globalThis.fetch;
+	afterEach(() => {
+		globalThis.fetch = orig;
+	});
+
+	it("reports a failed request instead of an empty history", async () => {
+		globalThis.fetch = vi.fn().mockResolvedValue({
+			ok: false,
+			status: 401,
+			json: async () => ({ detail: "oauth session required" })
+		}) as any;
+		const res = await list_bucket_records("http://x", "alice/h");
+		expect(res.ok).toBe(false);
+		expect(res.status).toBe(401);
+		expect(res.data).toEqual([]);
+	});
+
+	it("returns records on success", async () => {
+		globalThis.fetch = vi.fn().mockResolvedValue({
+			ok: true,
+			status: 200,
+			json: async () => ({ records: [{ record_id: "r1" }] })
+		}) as any;
+		const res = await list_bucket_records("http://x", "alice/h");
+		expect(res.ok).toBe(true);
+		expect(res.data).toHaveLength(1);
+	});
+
+	it("names the bucket on every request rather than relying on session state", async () => {
+		const spy = vi.fn().mockResolvedValue({
+			ok: true,
+			status: 200,
+			json: async () => ({ records: [] })
+		});
+		globalThis.fetch = spy as any;
+		await list_bucket_records("http://x", "alice/my-history");
+		const called = String(spy.mock.calls[0][0]);
+		expect(called).toContain("bucket=alice%2Fmy-history");
+		expect(called).not.toContain("endpoint=");
+		expect(called).not.toContain("limit=");
+	});
+
+	it("does not emit a root-absolute URL when root is empty", async () => {
+		const spy = vi.fn().mockResolvedValue({
+			ok: true,
+			status: 200,
+			json: async () => ({ records: [] })
+		});
+		globalThis.fetch = spy as any;
+		await list_bucket_records("", "alice/h");
+		const called = String(spy.mock.calls[0][0]);
+		// must resolve against the document base, not "/gradio_api/..."
+		expect(called.startsWith("/gradio_api/")).toBe(false);
+		expect(called).toContain("gradio_api/run-history/records");
+	});
+});
+
+describe("bucket setup", () => {
+	const orig = globalThis.fetch;
+	afterEach(() => {
+		globalThis.fetch = orig;
+	});
+
+	it("ignores the connect response body", async () => {
+		globalThis.fetch = vi.fn().mockResolvedValue({
+			ok: true,
+			status: 200,
+			json: async () => ({ ok: true })
+		}) as any;
+		const result = await connect_bucket("http://x", "alice/history");
+		expect(result).toMatchObject({ ok: true, data: null });
+	});
+
+	it("returns bucket ids as strings", async () => {
+		globalThis.fetch = vi.fn().mockResolvedValue({
+			ok: true,
+			status: 200,
+			json: async () => ({ buckets: ["alice/one", "alice/two"] })
+		}) as any;
+		expect(await list_user_buckets("http://x")).toMatchObject({
+			ok: true,
+			data: ["alice/one", "alice/two"]
+		});
+	});
+
+	it("preserves authentication errors for the connect UI", async () => {
+		globalThis.fetch = vi.fn().mockResolvedValue({
+			ok: false,
+			status: 401,
+			json: async () => ({ detail: "oauth session required" })
+		}) as any;
+		expect(await list_user_buckets("http://x")).toMatchObject({
+			ok: false,
+			status: 401,
+			data: [],
+			detail: "oauth session required"
+		});
+	});
+});
+
+describe("asset_url", () => {
+	it("addresses an asset by bucket, endpoint and record", () => {
+		const url = asset_url("http://x", "alice/h", "predict", "r1", "a001.png");
+		expect(url).toContain("/run-history/records/predict/r1/assets/a001.png");
+		expect(url).toContain("bucket=alice%2Fh");
+	});
+});

package/src/test/data.test.ts

@@ -5,6 +5,7 @@ import {
 	skip_queue,
 	post_message,
 	handle_file,
+	sign_file_urls,
 	handle_payload
 } from "../helpers/data";
 import { config_response, endpoint_info } from "./test_data";
@@ -359,6 +360,100 @@ describe("post_message", () => {
 	);
 });
 
+describe("sign_file_urls", () => {
+	it("signs nested file and stream URLs on the private Space origin", () => {
+		const data = {
+			image: {
+				path: "/tmp/cat.png",
+				url: "gradio_api/file=/tmp/cat.png?download=true",
+				meta: { _type: "gradio.FileData" }
+			},
+			gallery: [
+				{
+					image: {
+						path: "/tmp/tone.wav",
+						url: "/gradio_api/stream/tone.wav",
+						is_stream: true,
+						meta: { _type: "gradio.FileData" }
+					}
+				}
+			],
+			proxied: {
+				path: "https://nested-space.hf.space/gradio_api/file=/tmp/cat.png",
+				url: "/app/gradio_api/proxy=https://nested-space.hf.space/gradio_api/file=/tmp/cat.png",
+				meta: { _type: "gradio.FileData" }
+			}
+		};
+
+		sign_file_urls(
+			data,
+			"https://private-space.hf.space/app",
+			"/gradio_api",
+			"jwt_123"
+		);
+
+		expect(data.image.url).toBe(
+			"https://private-space.hf.space/app/gradio_api/file=/tmp/cat.png?download=true&__sign=jwt_123"
+		);
+		expect(data.gallery[0].image.url).toBe(
+			"https://private-space.hf.space/gradio_api/stream/tone.wav?__sign=jwt_123"
+		);
+		expect(data.proxied.url).toBe(
+			"https://private-space.hf.space/app/gradio_api/proxy=https://nested-space.hf.space/gradio_api/file=/tmp/cat.png?__sign=jwt_123"
+		);
+	});
+
+	it("does not sign external or unrelated same-origin URLs", () => {
+		const data = {
+			external: {
+				path: "https://cdn.example.com/cat.png",
+				url: "https://cdn.example.com/cat.png",
+				meta: { _type: "gradio.FileData" }
+			},
+			plain: {
+				url: "https://private-space.hf.space/gradio_api/file=/tmp/cat.png"
+			},
+			unrelated: {
+				path: "/tmp/cat.png",
+				url: "https://private-space.hf.space/api/custom-file",
+				meta: { _type: "gradio.FileData" }
+			}
+		};
+
+		sign_file_urls(
+			data,
+			"https://private-space.hf.space",
+			"/gradio_api",
+			"jwt_123"
+		);
+
+		expect(data.external.url).toBe("https://cdn.example.com/cat.png");
+		expect(data.plain.url).toBe(
+			"https://private-space.hf.space/gradio_api/file=/tmp/cat.png"
+		);
+		expect(data.unrelated.url).toBe(
+			"https://private-space.hf.space/api/custom-file"
+		);
+	});
+
+	it("does nothing without a Space JWT", () => {
+		const file = {
+			path: "/tmp/cat.png",
+			url: "https://private-space.hf.space/gradio_api/file=/tmp/cat.png",
+			meta: { _type: "gradio.FileData" }
+		};
+
+		sign_file_urls(
+			file,
+			"https://private-space.hf.space",
+			"/gradio_api",
+			false
+		);
+
+		expect(file.url).not.toContain("__sign");
+	});
+});
+
 describe("handle_file", () => {
 	it("should handle a Blob object and return the blob", () => {
 		const blob = new Blob(["test data"], { type: "image/png" });