tempest-react-sdk 0.80.0 → 0.82.0

package/dist/http/api-client.js

@@ -1,9 +1,9 @@
-import { randomId as e } from "../utils/ids.js";
-import { buildApiUrl as t } from "./build-url.js";
-import { isTrustedCredentialTarget as n, reportSuppressedCredential as r } from "./credential-scope.js";
-import { csrfHeaders as i } from "./csrf.js";
-import { decodeByContentType as a } from "./decode-response.js";
-import { SessionSupersededError as o, TempestApiError as s, buildApiError as c, isRetriableStatus as l } from "./errors.js";
+import { SessionSupersededError as e, TempestApiError as t, buildApiError as n, isRetriableStatus as r } from "./errors.js";
+import { randomId as i } from "../utils/ids.js";
+import { buildApiUrl as a } from "./build-url.js";
+import { isTrustedCredentialTarget as o, reportSuppressedCredential as s } from "./credential-scope.js";
+import { csrfHeaders as c } from "./csrf.js";
+import { decodeByContentType as l } from "./decode-response.js";
 import { retry as u } from "./retry.js";
 import { withTimeout as d } from "./timeout.js";
 //#region src/http/api-client.ts
@@ -12,188 +12,209 @@ var f = /* @__PURE__ */ new Set([
 	"HEAD",
 	"OPTIONS"
 ]);
-function p(e, t) {
-	return !f.has(t) || !(e instanceof s) ? !1 : l(e.status);
+function p(e, n) {
+	return !f.has(n) || !(e instanceof t) || e.code === h ? !1 : r(e.status);
 }
 function m(e) {
 	return e ? e === !0 ? {} : e : null;
 }
-var h = 15e3, g = 3e5;
-function _(e) {
+var h = "REDIRECT_REFUSED";
+function g(e) {
+	return e.type === "opaqueredirect" || e.status >= 300 && e.status < 400 && e.status !== 304;
+}
+var _ = 15e3, v = 3e5;
+function y(e) {
 	return typeof FormData < "u" && e instanceof FormData;
 }
-function v(e) {
+function b(e) {
 	return Math.round(performance.now() - e);
 }
-async function y(e, t) {
-	let n;
+function x(e) {
+	return e.replace(/[?#][^]*/, "").replace(/^([^/]*\/\/)[^/]*@/, "$1");
+}
+async function S(e, r) {
+	let i;
 	try {
-		n = await e.clone().json();
+		i = await e.clone().json();
 	} catch {
 		try {
-			n = await e.text();
+			i = await e.text();
 		} catch {
-			n = null;
+			i = null;
 		}
 	}
-	return new s(c(e.status, n, e.headers, t));
+	return new t(n(e.status, i, e.headers, r));
 }
-function b(c) {
-	let l = c.fetcher ?? globalThis.fetch.bind(globalThis);
-	function f(e, t) {
-		if (t) return {};
-		let i = c.getToken?.();
-		return i ? n(e, c.baseURL, c.trustedOrigins) ? { Authorization: `Bearer ${i}` } : (r(e, c.baseURL), {}) : {};
+function C(n) {
+	let r = n.fetcher ?? globalThis.fetch.bind(globalThis);
+	function f(e, t, r) {
+		let i = r ? null : n.getToken?.();
+		if (!t) {
+			i && s(e, n.baseURL);
+			let t = Object.keys(n.headers ?? {});
+			return t.length > 0 && s(e, n.baseURL, t.join(", ")), {};
+		}
+		return {
+			...n.headers,
+			...i ? { Authorization: `Bearer ${i}` } : {}
+		};
 	}
-	async function b(e, n, r, a) {
-		let { body: o, params: u, headers: p, signal: m, timeout: v, ...y } = n, b = _(o), x = b ? c.uploadTimeout : c.timeout, S = v === void 0 ? x === void 0 ? b ? g : h : x : v, C = t(c.baseURL, e, {
-			prefix: c.prefix,
-			params: u
-		}), w = p, T = {
-			...b ? {} : { "Content-Type": "application/json" },
-			...r ? { "X-Request-ID": r } : {},
-			...c.headers,
-			...f(C, a),
-			...i({
-				method: y.method ?? "GET",
-				url: C,
-				reference: c.baseURL,
-				csrf: c.csrf,
-				trustedOrigins: c.trustedOrigins,
+	async function C(e, i, a, o, s) {
+		let { body: l, headers: u, signal: p, timeout: m, ...b } = a, x = y(l), S = x ? n.uploadTimeout : n.timeout, C = m === void 0 ? S === void 0 ? x ? v : _ : S : m, w = u, T = {
+			...x ? {} : { "Content-Type": "application/json" },
+			...o ? { "X-Request-ID": o } : {},
+			...f(e, i, s),
+			...c({
+				method: b.method ?? "GET",
+				url: e,
+				reference: n.baseURL,
+				csrf: n.csrf,
+				trustedOrigins: n.trustedOrigins,
 				headers: {
-					...c.headers,
+					...n.headers,
 					...w
 				}
 			}),
 			...w
-		}, E = d(m, S), D = {
-			...y,
-			signal: E.signal,
+		}, E = i && b.redirect === void 0 && Object.keys(n.headers ?? {}).length > 0, D = d(p, C), O = {
+			...b,
+			...E ? { redirect: "manual" } : {},
+			signal: D.signal,
 			headers: T,
-			credentials: c.withCredentials ? "include" : y.credentials,
-			body: o == null ? void 0 : b ? o : JSON.stringify(o)
-		};
+			credentials: n.withCredentials ? "include" : b.credentials,
+			body: l == null ? void 0 : x ? l : JSON.stringify(l)
+		}, k;
 		try {
-			return await l(C, D);
+			k = await r(e, O);
 		} catch (e) {
-			throw E.timedOut() ? new s({
+			throw D.timedOut() ? new t({
 				status: 0,
-				detail: `A requisição excedeu ${S}ms e foi abandonada.`
+				detail: `A requisição excedeu ${C}ms e foi abandonada.`
 			}) : e;
 		} finally {
-			E.dispose();
+			D.dispose();
 		}
+		if (E && g(k)) throw new t({
+			status: k.status,
+			code: h,
+			requestId: o,
+			detail: "Redirect não seguido: a requisição levava os headers fixos do cliente."
+		});
+		return k;
 	}
-	async function x(e, t, n, r, i) {
-		let a = c.logger;
-		if (!a) return b(e, t, n, i);
-		let o = performance.now();
+	async function w(e, t, r, i, a, o, s) {
+		let c = n.logger;
+		if (!c) return C(t, r, i, a, s);
+		let l = `${o} ${x(e)}`, u = performance.now();
 		try {
-			let s = await b(e, t, n, i), c = {
-				requestId: n,
-				status: s.status,
-				ms: v(o)
-			}, l = `${r} ${e} → ${s.status}`;
-			return s.status >= 400 ? a.warn(l, c) : a.debug(l, c), s;
-		} catch (t) {
-			throw a.warn(`${r} ${e} → no response`, {
-				requestId: n,
-				ms: v(o),
-				error: t
-			}), t;
+			let e = await C(t, r, i, a, s), n = {
+				requestId: a,
+				status: e.status,
+				ms: b(u)
+			}, o = `${l} → ${e.status}`;
+			return e.status >= 400 ? c.warn(o, n) : c.debug(o, n), e;
+		} catch (e) {
+			throw c.warn(`${l} → no response`, {
+				requestId: a,
+				ms: b(u),
+				error: e
+			}), e;
 		}
 	}
-	async function S(e, t, n) {
-		if (c.onUnauthorized) {
-			c.logger?.warn("unauthorized — calling onUnauthorized", {
-				requestId: t,
-				status: e.status
+	async function T(t, r, i) {
+		if (n.onUnauthorized) {
+			n.logger?.warn("unauthorized — calling onUnauthorized", {
+				requestId: r,
+				status: t.status
 			});
 			try {
-				await c.onUnauthorized(e, n);
-			} catch (n) {
-				if (n instanceof o) throw n;
-				c.logger?.warn("onUnauthorized threw — keeping the original response error", {
-					requestId: t,
-					status: e.status,
-					error: n
+				await n.onUnauthorized(t, i);
+			} catch (i) {
+				if (i instanceof e) throw i;
+				n.logger?.warn("onUnauthorized threw — keeping the original response error", {
+					requestId: r,
+					status: t.status,
+					error: i
 				});
 			}
 		}
 	}
-	function C(e) {
+	function E(e) {
 		return {
-			token: e ? null : c.getToken?.() ?? null,
-			epoch: c.getSessionEpoch?.() ?? null
+			token: e ? null : n.getToken?.() ?? null,
+			epoch: n.getSessionEpoch?.() ?? null
 		};
 	}
-	async function w(t, n, r) {
-		let { skipAuth: i = !1, skipAuthRetry: a = !1, ...s } = n, l = c.requestId ? c.requestId() : e(), u = (s.method ?? "GET").toUpperCase(), d = C(i), f = await x(t, s, l, u, i);
-		if (f.status === 401 && !i && !a) {
-			if (c.refresh) {
-				let e;
+	async function D(t, r, s) {
+		let { skipAuth: c = !1, skipAuthRetry: l = !1, params: u, ...d } = r, f = n.requestId ? n.requestId() : i(), p = (d.method ?? "GET").toUpperCase(), m = a(n.baseURL, t, {
+			prefix: n.prefix,
+			params: u
+		}), h = o(m, n.baseURL, n.trustedOrigins), g = E(c), _ = await w(t, m, h, d, f, p, c);
+		if (_.status === 401 && h && !c && !l) {
+			if (n.refresh) {
+				let r;
 				try {
-					await c.refresh(d), e = C(i), f = await x(t, s, l, u, i);
-				} catch (e) {
-					throw e instanceof o ? e : (await S(f, l, d), await y(f, l));
+					await n.refresh(g), r = E(c), _ = await w(t, m, h, d, f, p, c);
+				} catch (t) {
+					throw t instanceof e ? t : (await T(_, f, g), await S(_, f));
 				}
-				f.status === 401 && await S(f, l, e);
-			} else await S(f, l, d);
+				_.status === 401 && await T(_, f, r);
+			} else await T(_, f, g);
 		}
-		if (!f.ok) throw await y(f, l);
-		return r(f);
+		if (!_.ok) throw await S(_, f);
+		return s(_);
 	}
-	async function T(e, t, n) {
-		let { retry: r, ...i } = t, a = m(r === void 0 ? c.retry : r);
-		if (!a) return w(e, i, n);
-		let o = (i.method ?? "GET").toUpperCase();
-		return u(() => w(e, i, n), {
-			...a,
-			shouldRetry: a.shouldRetry ?? ((e) => p(e, o))
+	async function O(e, t, r) {
+		let { retry: i, ...a } = t, o = m(i === void 0 ? n.retry : i);
+		if (!o) return D(e, a, r);
+		let s = (a.method ?? "GET").toUpperCase();
+		return u(() => D(e, a, r), {
+			...o,
+			shouldRetry: o.shouldRetry ?? ((e) => p(e, s))
 		});
 	}
-	async function E(e, t = {}) {
-		return T(e, t, a);
+	async function k(e, t = {}) {
+		return O(e, t, l);
 	}
-	async function D(e, t, n = "POST", r) {
-		return E(e, {
+	async function A(e, t, n = "POST", r) {
+		return k(e, {
 			...r,
 			method: n,
 			body: t
 		});
 	}
 	return {
-		request: E,
-		get: (e, t) => E(e, {
+		request: k,
+		get: (e, t) => k(e, {
 			...t,
 			method: "GET"
 		}),
-		post: (e, t) => E(e, {
+		post: (e, t) => k(e, {
 			...t,
 			method: "POST"
 		}),
-		put: (e, t) => E(e, {
+		put: (e, t) => k(e, {
 			...t,
 			method: "PUT"
 		}),
-		patch: (e, t) => E(e, {
+		patch: (e, t) => k(e, {
 			...t,
 			method: "PATCH"
 		}),
-		delete: (e, t) => E(e, {
+		delete: (e, t) => k(e, {
 			...t,
 			method: "DELETE"
 		}),
-		blob: (e, t) => T(e, { ...t }, (e) => e.blob()),
-		arrayBuffer: (e, t) => T(e, { ...t }, (e) => e.arrayBuffer()),
-		upload: D,
-		url: (e, n) => t(c.baseURL, e, {
-			prefix: c.prefix,
-			params: n
+		blob: (e, t) => O(e, { ...t }, (e) => e.blob()),
+		arrayBuffer: (e, t) => O(e, { ...t }, (e) => e.arrayBuffer()),
+		upload: A,
+		url: (e, t) => a(n.baseURL, e, {
+			prefix: n.prefix,
+			params: t
 		})
 	};
 }
 //#endregion
-export { b as createApiClient };
+export { C as createApiClient };
 
 //# sourceMappingURL=api-client.js.map

package/dist/http/api-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-client.js","names":["retryWithBackoff","IDEMPOTENT_METHODS","isRetriableFailure","method","error","TempestApiError","isRetriableStatus","resolveRetry","config","DEFAULT_TIMEOUT","DEFAULT_UPLOAD_TIMEOUT","isFormData","body","elapsedMs","startedAt","parseError","response","buildApiError","sentRequestId","createApiClient","fetcher","authHeaders","skipAuth","token","isTrustedCredentialTarget","url","reportSuppressedCredential","rawRequest","rest","options","isForm","configured","limit","timeout","buildApiUrl","path","callerHeaders","headers","finalHeaders","requestId","csrfHeaders","timed","withTimeout","signal","init","cause","send","log","entry","line","notifyUnauthorized","context","SessionSupersededError","authContext","attempt","randomId","sent","skipAuthRetry","replayed","decode","run","perRequest","retryOptions","retry","request","decodeByContentType","upload","formData"],"sources":["../../src/http/api-client.ts"],"sourcesContent":["/**\n * @tempest-limits function-lines — createApiClient is over the limit and every line\n * is a request-lifecycle concern the client cannot delegate: base URL joining, the\n * auth header, the 401 refresh-and-replay, the opt-in retry wrapper and the response\n * parsing that turns a failure into a typed error.\n */\nimport { randomId } from \"../utils\";\nimport { buildApiUrl } from \"./build-url\";\nimport { isTrustedCredentialTarget, reportSuppressedCredential } from \"./credential-scope\";\nimport { csrfHeaders } from \"./csrf\";\nimport { decodeByContentType } from \"./decode-response\";\nimport type { ResponseDecoder } from \"./decode-response\";\nimport {\n    buildApiError,\n    SessionSupersededError,\n    TempestApiError,\n    isRetriableStatus,\n} from \"./errors\";\nimport { retry as retryWithBackoff } from \"./retry\";\nimport type { RetryOptions } from \"./retry\";\nimport { withTimeout } from \"./timeout\";\nimport type { ApiClient, ApiClientConfig, RequestAuthContext, RequestOptions } from \"./types\";\n\n/**\n * Methods the built-in retry policy will replay.\n *\n * `PUT` and `DELETE` are idempotent on paper but stay out: a backend that logs,\n * bills, or fires a webhook per call still sees two, so replaying them is a\n * decision the caller makes through `shouldRetry`, not a default.\n */\nconst IDEMPOTENT_METHODS: ReadonlySet<string> = new Set([\"GET\", \"HEAD\", \"OPTIONS\"]);\n\n/**\n * Sub-500 statuses worth a second attempt: a network failure (status `0`), a\n * request timeout, a too-early replay, and a rate limit — which usually carries\n * the `Retry-After` the backoff already honours.\n */\n\n/**\n * The built-in retry policy, used when `retry` is `true` or is options carrying\n * no `shouldRetry` of their own.\n *\n * Conservative on purpose. Replaying a write can duplicate it, and replaying a\n * `400` or a `403` cannot fix a bad payload or a permission the caller does not\n * have — it only spends the user's time before showing the same error.\n *\n * @param error - Whatever the attempt threw.\n * @param method - The upper-cased HTTP method of the request.\n * @returns Whether the client should try again.\n */\nfunction isRetriableFailure(error: unknown, method: string): boolean {\n    if (!IDEMPOTENT_METHODS.has(method)) return false;\n    if (!(error instanceof TempestApiError)) return false;\n    return isRetriableStatus(error.status);\n}\n\n/**\n * Normalize the `retry` config into options, or `null` when retrying is off.\n *\n * @param config - The `retry` field as the caller wrote it.\n * @returns Retry options to use, or `null` to run a single attempt.\n */\nfunction resolveRetry(config: boolean | RetryOptions | undefined): RetryOptions | null {\n    if (!config) return null;\n    return config === true ? {} : config;\n}\n\n/** Default milliseconds before a request is abandoned. */\nconst DEFAULT_TIMEOUT = 15_000;\n\n/** Default milliseconds before a `FormData` request is abandoned. */\nconst DEFAULT_UPLOAD_TIMEOUT = 300_000;\n\nfunction isFormData(body: unknown): body is FormData {\n    return typeof FormData !== \"undefined\" && body instanceof FormData;\n}\n\n/**\n * Milliseconds since a `performance.now()` reading, rounded.\n *\n * `performance.now()` rather than `Date.now()` because this measures a\n * duration: the wall clock can step sideways mid-request (an NTP correction, a\n * VM resuming, the user changing the clock) and turn a 40 ms call into a\n * negative number. The monotonic clock cannot.\n *\n * @param startedAt - The reading taken before the work started.\n * @returns Whole milliseconds elapsed.\n */\nfunction elapsedMs(startedAt: number): number {\n    return Math.round(performance.now() - startedAt);\n}\n\nasync function parseError(response: Response, sentRequestId?: string): Promise<TempestApiError> {\n    let body: unknown;\n    try {\n        body = await response.clone().json();\n    } catch {\n        try {\n            body = await response.text();\n        } catch {\n            body = null;\n        }\n    }\n    return new TempestApiError(\n        buildApiError(response.status, body, response.headers, sentRequestId),\n    );\n}\n\n/**\n * Create a typed HTTP client backed by `fetch`.\n *\n * Handles JSON serialization, query params, bearer auth via `getToken`, uploads\n * via `FormData`, and throws a typed `ApiError` on any non-2xx response.\n *\n * **Expired sessions.** A `401` with `refresh` configured awaits the refresh and\n * replays the request once. `onUnauthorized` fires whenever that path ends\n * unauthorized anyway — the refresh threw, or the replay came back `401` — which\n * is the signal to clear the session. Without `refresh`, the first `401` calls\n * it directly.\n *\n * **Binary bodies** have their own methods — `blob()` and `arrayBuffer()` — which\n * run the same pipeline and skip the parse. `request()` no longer decodes an\n * unknown `Content-Type` as text either: it returns a `Blob` and says so once in\n * a development build, because reading `image/jpeg` as UTF-8 destroyed the bytes\n * on the way in.\n *\n * **The bearer token is scoped to `baseURL`'s origin** since 0.66.0. A path may\n * be an absolute URL, which overrides the base entirely, so without a scope the\n * destination of a credentialed request could come from a value read off the\n * network. A request to another origin still goes out; it goes without the\n * header, and a development build says so once. Declare the exceptions in\n * {@link ApiClientConfig.trustedOrigins}.\n *\n * **CSRF** is off unless you set `csrf`. With it, every unsafe request (anything\n * but `GET`/`HEAD`/`OPTIONS`/`TRACE`) echoes the `csrf_token` cookie in an\n * `X-CSRF-Token` header — the double-submit contract of `tempest-fastapi-sdk`'s\n * `CSRFMiddleware` — scoped to the same origins as the bearer token and sent on\n * `skipAuth` requests too. See {@link ApiClientConfig.csrf}.\n *\n * **Retries** are off unless you set `retry`. See {@link ApiClientConfig.retry}\n * for the built-in policy; it never replays a write. A single call overrides it\n * with {@link RequestOptions.retry}, and opts out of auth entirely with\n * {@link RequestOptions.skipAuth}.\n *\n * **Logging** is off unless you pass a `logger`. With one, every finished attempt\n * writes a line — `debug` under 400, `warn` from 400 up, plus a `warn` when\n * `onUnauthorized` fires — carrying `requestId`, `status` and elapsed `ms`, and\n * never a body, header or query string. The level and the destination belong to\n * the logger, not to a boolean here.\n *\n * @example\n * const api = createApiClient({\n *     baseURL: import.meta.env.VITE_API_URL,\n *     getToken: () => useAuthStore.getState().token,\n *     refresh,\n *     onUnauthorized: () => useAuthStore.getState().logout(),\n *     logger: createLogger({ level: import.meta.env.DEV ? \"debug\" : \"warn\" }).child(\"http\"),\n *     retry: true,\n * });\n *\n * @param config - Base URL plus the optional auth, retry and fetch hooks.\n * @returns A client with `request`/`get`/`post`/`put`/`patch`/`delete`/`blob`/\n * `arrayBuffer`/`upload`.\n */\nexport function createApiClient(config: ApiClientConfig): ApiClient {\n    const fetcher = config.fetcher ?? globalThis.fetch.bind(globalThis);\n\n    /**\n     * The `Authorization` header for a request, or nothing.\n     *\n     * Takes the resolved URL rather than reading `config.baseURL`, because an\n     * absolute path overrides the base entirely (see `buildApiUrl`) and the\n     * credential is scoped to an origin, not to a client.\n     *\n     * @param url - The absolute URL the request is going to.\n     * @param skipAuth - Whether the caller opted this request out of auth.\n     * @returns The header, or an empty object.\n     */\n    function authHeaders(url: string, skipAuth: boolean): Record<string, string> {\n        if (skipAuth) return {};\n        const token = config.getToken?.();\n        if (!token) return {};\n        if (!isTrustedCredentialTarget(url, config.baseURL, config.trustedOrigins)) {\n            reportSuppressedCredential(url, config.baseURL);\n            return {};\n        }\n        return { Authorization: `Bearer ${token}` };\n    }\n\n    async function rawRequest(\n        path: string,\n        options: RequestOptions,\n        requestId: string | undefined,\n        skipAuth: boolean,\n    ): Promise<Response> {\n        const { body, params, headers, signal, timeout, ...rest } = options;\n        const isForm = isFormData(body);\n        const configured = isForm ? config.uploadTimeout : config.timeout;\n        const fallback = isForm ? DEFAULT_UPLOAD_TIMEOUT : DEFAULT_TIMEOUT;\n        const limit =\n            timeout !== undefined ? timeout : configured !== undefined ? configured : fallback;\n\n        const url = buildApiUrl(config.baseURL, path, { prefix: config.prefix, params });\n\n        const callerHeaders = headers as Record<string, string> | undefined;\n        const finalHeaders: Record<string, string> = {\n            ...(isForm ? {} : { \"Content-Type\": \"application/json\" }),\n            ...(requestId ? { \"X-Request-ID\": requestId } : {}),\n            ...config.headers,\n            ...authHeaders(url, skipAuth),\n            ...csrfHeaders({\n                method: rest.method ?? \"GET\",\n                url,\n                reference: config.baseURL,\n                csrf: config.csrf,\n                trustedOrigins: config.trustedOrigins,\n                headers: { ...config.headers, ...callerHeaders },\n            }),\n            ...callerHeaders,\n        };\n\n        const timed = withTimeout(signal, limit);\n        const init: RequestInit = {\n            ...rest,\n            signal: timed.signal,\n            headers: finalHeaders,\n            credentials: config.withCredentials ? \"include\" : rest.credentials,\n            body:\n                body === undefined || body === null\n                    ? undefined\n                    : isForm\n                      ? (body as FormData)\n                      : JSON.stringify(body),\n        };\n\n        try {\n            return await fetcher(url, init);\n        } catch (cause) {\n            if (timed.timedOut()) {\n                throw new TempestApiError({\n                    status: 0,\n                    detail: `A requisição excedeu ${limit}ms e foi abandonada.`,\n                });\n            }\n            throw cause;\n        } finally {\n            timed.dispose();\n        }\n    }\n\n    async function send(\n        path: string,\n        options: RequestOptions,\n        requestId: string,\n        method: string,\n        skipAuth: boolean,\n    ): Promise<Response> {\n        const log = config.logger;\n        if (!log) return rawRequest(path, options, requestId, skipAuth);\n\n        const startedAt = performance.now();\n        try {\n            const response = await rawRequest(path, options, requestId, skipAuth);\n            const entry = { requestId, status: response.status, ms: elapsedMs(startedAt) };\n            const line = `${method} ${path} → ${response.status}`;\n            if (response.status >= 400) log.warn(line, entry);\n            else log.debug(line, entry);\n            return response;\n        } catch (error) {\n            log.warn(`${method} ${path} → no response`, {\n                requestId,\n                ms: elapsedMs(startedAt),\n                error,\n            });\n            throw error;\n        }\n    }\n\n    /**\n     * Call `onUnauthorized`, keeping the request's own error unless the hook\n     * says the attempt belongs to an ended session.\n     *\n     * @param response - The `401` that ended the attempt.\n     * @param requestId - Correlation id for the log.\n     * @param context - The credential and session the attempt left with.\n     * @throws {SessionSupersededError} When `onUnauthorized` threw it.\n     */\n    async function notifyUnauthorized(\n        response: Response,\n        requestId: string,\n        context: RequestAuthContext,\n    ): Promise<void> {\n        if (!config.onUnauthorized) return;\n        config.logger?.warn(`unauthorized — calling onUnauthorized`, {\n            requestId,\n            status: response.status,\n        });\n        try {\n            await config.onUnauthorized(response, context);\n        } catch (error) {\n            if (error instanceof SessionSupersededError) throw error;\n            config.logger?.warn(`onUnauthorized threw — keeping the original response error`, {\n                requestId,\n                status: response.status,\n                error,\n            });\n        }\n    }\n\n    /**\n     * The credential and session an attempt leaves with, read just before it is\n     * sent.\n     *\n     * @param skipAuth - Whether the attempt goes out without credentials.\n     * @returns The context handed to `refresh` and `onUnauthorized`.\n     */\n    function authContext(skipAuth: boolean): RequestAuthContext {\n        return {\n            token: skipAuth ? null : (config.getToken?.() ?? null),\n            epoch: config.getSessionEpoch?.() ?? null,\n        };\n    }\n\n    async function attempt<T>(\n        path: string,\n        options: RequestOptions,\n        decode: ResponseDecoder<T>,\n    ): Promise<T> {\n        const { skipAuth = false, skipAuthRetry = false, ...init } = options;\n        const requestId = config.requestId ? config.requestId() : randomId();\n        const method = (init.method ?? \"GET\").toUpperCase();\n        const sent = authContext(skipAuth);\n        let response = await send(path, init, requestId, method, skipAuth);\n\n        if (response.status === 401 && !skipAuth && !skipAuthRetry) {\n            if (config.refresh) {\n                let replayed: RequestAuthContext;\n                try {\n                    await config.refresh(sent);\n                    replayed = authContext(skipAuth);\n                    response = await send(path, init, requestId, method, skipAuth);\n                } catch (error) {\n                    if (error instanceof SessionSupersededError) throw error;\n                    await notifyUnauthorized(response, requestId, sent);\n                    throw await parseError(response, requestId);\n                }\n                if (response.status === 401) {\n                    await notifyUnauthorized(response, requestId, replayed);\n                }\n            } else {\n                await notifyUnauthorized(response, requestId, sent);\n            }\n        }\n\n        if (!response.ok) {\n            throw await parseError(response, requestId);\n        }\n\n        return decode(response);\n    }\n\n    async function run<T>(\n        path: string,\n        options: RequestOptions,\n        decode: ResponseDecoder<T>,\n    ): Promise<T> {\n        const { retry: perRequest, ...rest } = options;\n        const retryOptions = resolveRetry(perRequest !== undefined ? perRequest : config.retry);\n        if (!retryOptions) return attempt<T>(path, rest, decode);\n\n        const method = (rest.method ?? \"GET\").toUpperCase();\n        return retryWithBackoff(() => attempt<T>(path, rest, decode), {\n            ...retryOptions,\n            shouldRetry:\n                retryOptions.shouldRetry ?? ((error: unknown) => isRetriableFailure(error, method)),\n        });\n    }\n\n    async function request<T>(path: string, options: RequestOptions = {}): Promise<T> {\n        return run<T>(path, options, decodeByContentType);\n    }\n\n    async function upload<T>(\n        path: string,\n        formData: FormData,\n        method: \"POST\" | \"PUT\" | \"PATCH\" = \"POST\",\n        options?: Omit<RequestOptions, \"body\" | \"method\">,\n    ): Promise<T> {\n        return request<T>(path, { ...options, method, body: formData });\n    }\n\n    return {\n        request,\n        get: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"GET\" }),\n        post: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"POST\" }),\n        put: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"PUT\" }),\n        patch: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"PATCH\" }),\n        delete: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"DELETE\" }),\n        blob: (path: string, options?: RequestOptions) =>\n            run<Blob>(path, { ...options }, (response) => response.blob()),\n        arrayBuffer: (path: string, options?: RequestOptions) =>\n            run<ArrayBuffer>(path, { ...options }, (response) => response.arrayBuffer()),\n        upload,\n        url: (path: string, params?: RequestOptions[\"params\"]) =>\n            buildApiUrl(config.baseURL, path, { prefix: config.prefix, params }),\n    };\n}\n"],"mappings":"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"}
+{"version":3,"file":"api-client.js","names":["retryWithBackoff","IDEMPOTENT_METHODS","isRetriableFailure","method","error","TempestApiError","REDIRECT_REFUSED","isRetriableStatus","resolveRetry","config","isStoppedRedirect","response","DEFAULT_TIMEOUT","DEFAULT_UPLOAD_TIMEOUT","isFormData","body","elapsedMs","startedAt","pathForLog","path","parseError","buildApiError","sentRequestId","createApiClient","fetcher","scopedHeaders","token","skipAuth","inScope","reportSuppressedCredential","url","names","rawRequest","rest","options","isForm","configured","limit","timeout","callerHeaders","headers","finalHeaders","requestId","csrfHeaders","holdRedirects","timed","withTimeout","signal","init","cause","send","log","target","entry","line","notifyUnauthorized","context","SessionSupersededError","authContext","attempt","randomId","buildApiUrl","isTrustedCredentialTarget","sent","skipAuthRetry","replayed","decode","run","perRequest","retryOptions","retry","request","decodeByContentType","upload","formData"],"sources":["../../src/http/api-client.ts"],"sourcesContent":["/**\n * @tempest-limits function-lines — createApiClient is over the limit and every line\n * is a request-lifecycle concern the client cannot delegate: base URL joining, the\n * auth header, the 401 refresh-and-replay, the opt-in retry wrapper and the response\n * parsing that turns a failure into a typed error.\n */\nimport { randomId } from \"../utils\";\nimport { buildApiUrl } from \"./build-url\";\nimport { isTrustedCredentialTarget, reportSuppressedCredential } from \"./credential-scope\";\nimport { csrfHeaders } from \"./csrf\";\nimport { decodeByContentType } from \"./decode-response\";\nimport type { ResponseDecoder } from \"./decode-response\";\nimport {\n    buildApiError,\n    SessionSupersededError,\n    TempestApiError,\n    isRetriableStatus,\n} from \"./errors\";\nimport { retry as retryWithBackoff } from \"./retry\";\nimport type { RetryOptions } from \"./retry\";\nimport { withTimeout } from \"./timeout\";\nimport type { ApiClient, ApiClientConfig, RequestAuthContext, RequestOptions } from \"./types\";\n\n/**\n * Methods the built-in retry policy will replay.\n *\n * `PUT` and `DELETE` are idempotent on paper but stay out: a backend that logs,\n * bills, or fires a webhook per call still sees two, so replaying them is a\n * decision the caller makes through `shouldRetry`, not a default.\n */\nconst IDEMPOTENT_METHODS: ReadonlySet<string> = new Set([\"GET\", \"HEAD\", \"OPTIONS\"]);\n\n/**\n * Sub-500 statuses worth a second attempt: a network failure (status `0`), a\n * request timeout, a too-early replay, and a rate limit — which usually carries\n * the `Retry-After` the backoff already honours.\n */\n\n/**\n * The built-in retry policy, used when `retry` is `true` or is options carrying\n * no `shouldRetry` of their own.\n *\n * Conservative on purpose. Replaying a write can duplicate it, and replaying a\n * `400` or a `403` cannot fix a bad payload or a permission the caller does not\n * have — it only spends the user's time before showing the same error.\n *\n * @param error - Whatever the attempt threw.\n * @param method - The upper-cased HTTP method of the request.\n * @returns Whether the client should try again.\n */\nfunction isRetriableFailure(error: unknown, method: string): boolean {\n    if (!IDEMPOTENT_METHODS.has(method)) return false;\n    if (!(error instanceof TempestApiError)) return false;\n    if (error.code === REDIRECT_REFUSED) return false;\n    return isRetriableStatus(error.status);\n}\n\n/**\n * Normalize the `retry` config into options, or `null` when retrying is off.\n *\n * @param config - The `retry` field as the caller wrote it.\n * @returns Retry options to use, or `null` to run a single attempt.\n */\nfunction resolveRetry(config: boolean | RetryOptions | undefined): RetryOptions | null {\n    if (!config) return null;\n    return config === true ? {} : config;\n}\n\n/**\n * The `code` of the {@link TempestApiError} thrown when a request carrying the\n * client's static `headers` is answered with a redirect.\n *\n * Kept out of the built-in retry policy: the status is `0` in a browser, which\n * would otherwise read as a network failure, and replaying gets the same\n * redirect back.\n */\nconst REDIRECT_REFUSED = \"REDIRECT_REFUSED\";\n\n/**\n * Whether `response` is a redirect that `redirect: \"manual\"` stopped.\n *\n * Two shapes, measured: a browser hands back an `opaqueredirect` with status\n * `0` and no readable headers (Chrome 150, #554); a server runtime such as\n * Node's `fetch` hands back the real `3xx` with its `Location`. `304` is a\n * cache answer, not a redirect.\n *\n * @param response - What the fetcher resolved with.\n * @returns Whether the request was redirected and not followed.\n */\nfunction isStoppedRedirect(response: Response): boolean {\n    if (response.type === \"opaqueredirect\") return true;\n    return response.status >= 300 && response.status < 400 && response.status !== 304;\n}\n\n/** Default milliseconds before a request is abandoned. */\nconst DEFAULT_TIMEOUT = 15_000;\n\n/** Default milliseconds before a `FormData` request is abandoned. */\nconst DEFAULT_UPLOAD_TIMEOUT = 300_000;\n\nfunction isFormData(body: unknown): body is FormData {\n    return typeof FormData !== \"undefined\" && body instanceof FormData;\n}\n\n/**\n * Milliseconds since a `performance.now()` reading, rounded.\n *\n * `performance.now()` rather than `Date.now()` because this measures a\n * duration: the wall clock can step sideways mid-request (an NTP correction, a\n * VM resuming, the user changing the clock) and turn a 40 ms call into a\n * negative number. The monotonic clock cannot.\n *\n * @param startedAt - The reading taken before the work started.\n * @returns Whole milliseconds elapsed.\n */\nfunction elapsedMs(startedAt: number): number {\n    return Math.round(performance.now() - startedAt);\n}\n\n/**\n * The request path as the log line shows it: no query, no fragment, no userinfo.\n *\n * The logger promises never to write the query string, and `params` was never\n * the only way one gets in: a call site can write `\"/files?access_token=…\"`\n * inline, and an absolute path — the signed upload endpoint or CDN URL that\n * `buildApiUrl` passes through untouched — carries its signature in the query\n * and may carry `user:password@` in the authority. Everything from the first\n * `?` or `#` is dropped and the userinfo of an absolute (or scheme-relative)\n * URL is removed; the host and the path stay, because they are what makes the\n * line useful. Pure string work, no `URL` round trip, so a path that would not\n * parse is still logged instead of throwing inside the logging branch.\n *\n * @param path - The path exactly as the call site passed it.\n * @returns The path without query, fragment or credentials.\n */\nfunction pathForLog(path: string): string {\n    return path.replace(/[?#][^]*/, \"\").replace(/^([^/]*\\/\\/)[^/]*@/, \"$1\");\n}\n\nasync function parseError(response: Response, sentRequestId?: string): Promise<TempestApiError> {\n    let body: unknown;\n    try {\n        body = await response.clone().json();\n    } catch {\n        try {\n            body = await response.text();\n        } catch {\n            body = null;\n        }\n    }\n    return new TempestApiError(\n        buildApiError(response.status, body, response.headers, sentRequestId),\n    );\n}\n\n/**\n * Create a typed HTTP client backed by `fetch`.\n *\n * Handles JSON serialization, query params, bearer auth via `getToken`, uploads\n * via `FormData`, and throws a typed `ApiError` on any non-2xx response.\n *\n * **Expired sessions.** A `401` with `refresh` configured awaits the refresh and\n * replays the request once. `onUnauthorized` fires whenever that path ends\n * unauthorized anyway — the refresh threw, or the replay came back `401` — which\n * is the signal to clear the session. Without `refresh`, the first `401` calls\n * it directly.\n *\n * **Binary bodies** have their own methods — `blob()` and `arrayBuffer()` — which\n * run the same pipeline and skip the parse. `request()` no longer decodes an\n * unknown `Content-Type` as text either: it returns a `Blob` and says so once in\n * a development build, because reading `image/jpeg` as UTF-8 destroyed the bytes\n * on the way in.\n *\n * **The bearer token is scoped to `baseURL`'s origin** since 0.66.0. A path may\n * be an absolute URL, which overrides the base entirely, so without a scope the\n * destination of a credentialed request could come from a value read off the\n * network. A request to another origin still goes out; it goes without the\n * header, and a development build says so once. Declare the exceptions in\n * {@link ApiClientConfig.trustedOrigins}. Since 0.82.0 the static\n * {@link ApiClientConfig.headers} follow the same scope, and a `401` from\n * outside it is thrown without `refresh` or `onUnauthorized` — it answered a\n * request that never carried this session's credential.\n *\n * **Redirects.** The scope is checked against the URL the request starts at;\n * where a redirect then goes is the transport's call. For `Authorization` that\n * is safe: browsers strip it on a cross-origin redirect, measured in Chrome 150\n * for `fetch` and XHR on `301`/`302`/`303`/`307`/`308` (#554). They strip\n * nothing else, so a request carrying the static {@link ApiClientConfig.headers}\n * goes out with `redirect: \"manual\"`, and a redirect answering it is thrown as a\n * {@link TempestApiError} with `code: \"REDIRECT_REFUSED\"` instead of being\n * followed. It cannot be followed by hand: a browser's manual redirect is an\n * opaque response whose `Location` is unreadable. A `redirect` set on the call\n * always wins.\n *\n * **CSRF** is off unless you set `csrf`. With it, every unsafe request (anything\n * but `GET`/`HEAD`/`OPTIONS`/`TRACE`) echoes the `csrf_token` cookie in an\n * `X-CSRF-Token` header — the double-submit contract of `tempest-fastapi-sdk`'s\n * `CSRFMiddleware` — scoped to the same origins as the bearer token and sent on\n * `skipAuth` requests too. See {@link ApiClientConfig.csrf}.\n *\n * **Retries** are off unless you set `retry`. See {@link ApiClientConfig.retry}\n * for the built-in policy; it never replays a write. A single call overrides it\n * with {@link RequestOptions.retry}, and opts out of auth entirely with\n * {@link RequestOptions.skipAuth}.\n *\n * **Logging** is off unless you pass a `logger`. With one, every finished attempt\n * writes a line — `debug` under 400, `warn` from 400 up, plus a `warn` when\n * `onUnauthorized` fires — carrying `requestId`, `status` and elapsed `ms`, and\n * never a body, header or query string. The level and the destination belong to\n * the logger, not to a boolean here.\n *\n * @example\n * const api = createApiClient({\n *     baseURL: import.meta.env.VITE_API_URL,\n *     getToken: () => useAuthStore.getState().token,\n *     refresh,\n *     onUnauthorized: () => useAuthStore.getState().logout(),\n *     logger: createLogger({ level: import.meta.env.DEV ? \"debug\" : \"warn\" }).child(\"http\"),\n *     retry: true,\n * });\n *\n * @param config - Base URL plus the optional auth, retry and fetch hooks.\n * @returns A client with `request`/`get`/`post`/`put`/`patch`/`delete`/`blob`/\n * `arrayBuffer`/`upload`.\n */\nexport function createApiClient(config: ApiClientConfig): ApiClient {\n    const fetcher = config.fetcher ?? globalThis.fetch.bind(globalThis);\n\n    /**\n     * The headers that belong to the client's credential scope — the static\n     * `config.headers` and the `Authorization` header — or nothing.\n     *\n     * Takes the resolved URL rather than reading `config.baseURL`, because an\n     * absolute path overrides the base entirely (see `buildApiUrl`) and the\n     * credential is scoped to an origin, not to a client. Static headers ride\n     * with the token since 0.82.0: an `X-Api-Key` set once on the client is as\n     * much a credential as the bearer (#530).\n     *\n     * @param url - The absolute URL the request is going to.\n     * @param inScope - Whether `url` is inside the credential scope.\n     * @param skipAuth - Whether the caller opted this request out of auth.\n     * @returns The headers, or an empty object.\n     */\n    function scopedHeaders(\n        url: string,\n        inScope: boolean,\n        skipAuth: boolean,\n    ): Record<string, string> {\n        const token = skipAuth ? null : config.getToken?.();\n        if (!inScope) {\n            if (token) reportSuppressedCredential(url, config.baseURL);\n            const names = Object.keys(config.headers ?? {});\n            if (names.length > 0) reportSuppressedCredential(url, config.baseURL, names.join(\", \"));\n            return {};\n        }\n        return { ...config.headers, ...(token ? { Authorization: `Bearer ${token}` } : {}) };\n    }\n\n    async function rawRequest(\n        url: string,\n        inScope: boolean,\n        options: RequestOptions,\n        requestId: string | undefined,\n        skipAuth: boolean,\n    ): Promise<Response> {\n        const { body, headers, signal, timeout, ...rest } = options;\n        const isForm = isFormData(body);\n        const configured = isForm ? config.uploadTimeout : config.timeout;\n        const fallback = isForm ? DEFAULT_UPLOAD_TIMEOUT : DEFAULT_TIMEOUT;\n        const limit =\n            timeout !== undefined ? timeout : configured !== undefined ? configured : fallback;\n\n        const callerHeaders = headers as Record<string, string> | undefined;\n        const finalHeaders: Record<string, string> = {\n            ...(isForm ? {} : { \"Content-Type\": \"application/json\" }),\n            ...(requestId ? { \"X-Request-ID\": requestId } : {}),\n            ...scopedHeaders(url, inScope, skipAuth),\n            ...csrfHeaders({\n                method: rest.method ?? \"GET\",\n                url,\n                reference: config.baseURL,\n                csrf: config.csrf,\n                trustedOrigins: config.trustedOrigins,\n                headers: { ...config.headers, ...callerHeaders },\n            }),\n            ...callerHeaders,\n        };\n\n        const holdRedirects =\n            inScope && rest.redirect === undefined && Object.keys(config.headers ?? {}).length > 0;\n        const timed = withTimeout(signal, limit);\n        const init: RequestInit = {\n            ...rest,\n            ...(holdRedirects ? { redirect: \"manual\" as const } : {}),\n            signal: timed.signal,\n            headers: finalHeaders,\n            credentials: config.withCredentials ? \"include\" : rest.credentials,\n            body:\n                body === undefined || body === null\n                    ? undefined\n                    : isForm\n                      ? (body as FormData)\n                      : JSON.stringify(body),\n        };\n\n        let response: Response;\n        try {\n            response = await fetcher(url, init);\n        } catch (cause) {\n            if (timed.timedOut()) {\n                throw new TempestApiError({\n                    status: 0,\n                    detail: `A requisição excedeu ${limit}ms e foi abandonada.`,\n                });\n            }\n            throw cause;\n        } finally {\n            timed.dispose();\n        }\n        if (holdRedirects && isStoppedRedirect(response)) {\n            throw new TempestApiError({\n                status: response.status,\n                code: REDIRECT_REFUSED,\n                requestId,\n                detail: \"Redirect não seguido: a requisição levava os headers fixos do cliente.\",\n            });\n        }\n        return response;\n    }\n\n    async function send(\n        path: string,\n        url: string,\n        inScope: boolean,\n        options: RequestOptions,\n        requestId: string,\n        method: string,\n        skipAuth: boolean,\n    ): Promise<Response> {\n        const log = config.logger;\n        if (!log) return rawRequest(url, inScope, options, requestId, skipAuth);\n\n        const target = `${method} ${pathForLog(path)}`;\n        const startedAt = performance.now();\n        try {\n            const response = await rawRequest(url, inScope, options, requestId, skipAuth);\n            const entry = { requestId, status: response.status, ms: elapsedMs(startedAt) };\n            const line = `${target} → ${response.status}`;\n            if (response.status >= 400) log.warn(line, entry);\n            else log.debug(line, entry);\n            return response;\n        } catch (error) {\n            log.warn(`${target} → no response`, {\n                requestId,\n                ms: elapsedMs(startedAt),\n                error,\n            });\n            throw error;\n        }\n    }\n\n    /**\n     * Call `onUnauthorized`, keeping the request's own error unless the hook\n     * says the attempt belongs to an ended session.\n     *\n     * @param response - The `401` that ended the attempt.\n     * @param requestId - Correlation id for the log.\n     * @param context - The credential and session the attempt left with.\n     * @throws {SessionSupersededError} When `onUnauthorized` threw it.\n     */\n    async function notifyUnauthorized(\n        response: Response,\n        requestId: string,\n        context: RequestAuthContext,\n    ): Promise<void> {\n        if (!config.onUnauthorized) return;\n        config.logger?.warn(`unauthorized — calling onUnauthorized`, {\n            requestId,\n            status: response.status,\n        });\n        try {\n            await config.onUnauthorized(response, context);\n        } catch (error) {\n            if (error instanceof SessionSupersededError) throw error;\n            config.logger?.warn(`onUnauthorized threw — keeping the original response error`, {\n                requestId,\n                status: response.status,\n                error,\n            });\n        }\n    }\n\n    /**\n     * The credential and session an attempt leaves with, read just before it is\n     * sent.\n     *\n     * @param skipAuth - Whether the attempt goes out without credentials.\n     * @returns The context handed to `refresh` and `onUnauthorized`.\n     */\n    function authContext(skipAuth: boolean): RequestAuthContext {\n        return {\n            token: skipAuth ? null : (config.getToken?.() ?? null),\n            epoch: config.getSessionEpoch?.() ?? null,\n        };\n    }\n\n    /**\n     * One request, with the `401` refresh-and-replay around it.\n     *\n     * The refresh path runs only for a target inside the credential scope. A\n     * `401` from any other origin answers a request that never carried this\n     * session's credential, so it says nothing about the session; until 0.82.0\n     * it still drove `refresh()` and `onUnauthorized()`, so a foreign host could\n     * spend a refresh and end the user's session (#530).\n     *\n     * @param path - The path as the call site wrote it.\n     * @param options - Request options, policy fields included.\n     * @param decode - How to turn the response into a value.\n     * @returns The decoded value.\n     */\n    async function attempt<T>(\n        path: string,\n        options: RequestOptions,\n        decode: ResponseDecoder<T>,\n    ): Promise<T> {\n        const { skipAuth = false, skipAuthRetry = false, params, ...init } = options;\n        const requestId = config.requestId ? config.requestId() : randomId();\n        const method = (init.method ?? \"GET\").toUpperCase();\n        const url = buildApiUrl(config.baseURL, path, { prefix: config.prefix, params });\n        const inScope = isTrustedCredentialTarget(url, config.baseURL, config.trustedOrigins);\n        const sent = authContext(skipAuth);\n        let response = await send(path, url, inScope, init, requestId, method, skipAuth);\n\n        if (response.status === 401 && inScope && !skipAuth && !skipAuthRetry) {\n            if (config.refresh) {\n                let replayed: RequestAuthContext;\n                try {\n                    await config.refresh(sent);\n                    replayed = authContext(skipAuth);\n                    response = await send(path, url, inScope, init, requestId, method, skipAuth);\n                } catch (error) {\n                    if (error instanceof SessionSupersededError) throw error;\n                    await notifyUnauthorized(response, requestId, sent);\n                    throw await parseError(response, requestId);\n                }\n                if (response.status === 401) {\n                    await notifyUnauthorized(response, requestId, replayed);\n                }\n            } else {\n                await notifyUnauthorized(response, requestId, sent);\n            }\n        }\n\n        if (!response.ok) {\n            throw await parseError(response, requestId);\n        }\n\n        return decode(response);\n    }\n\n    async function run<T>(\n        path: string,\n        options: RequestOptions,\n        decode: ResponseDecoder<T>,\n    ): Promise<T> {\n        const { retry: perRequest, ...rest } = options;\n        const retryOptions = resolveRetry(perRequest !== undefined ? perRequest : config.retry);\n        if (!retryOptions) return attempt<T>(path, rest, decode);\n\n        const method = (rest.method ?? \"GET\").toUpperCase();\n        return retryWithBackoff(() => attempt<T>(path, rest, decode), {\n            ...retryOptions,\n            shouldRetry:\n                retryOptions.shouldRetry ?? ((error: unknown) => isRetriableFailure(error, method)),\n        });\n    }\n\n    async function request<T>(path: string, options: RequestOptions = {}): Promise<T> {\n        return run<T>(path, options, decodeByContentType);\n    }\n\n    async function upload<T>(\n        path: string,\n        formData: FormData,\n        method: \"POST\" | \"PUT\" | \"PATCH\" = \"POST\",\n        options?: Omit<RequestOptions, \"body\" | \"method\">,\n    ): Promise<T> {\n        return request<T>(path, { ...options, method, body: formData });\n    }\n\n    return {\n        request,\n        get: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"GET\" }),\n        post: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"POST\" }),\n        put: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"PUT\" }),\n        patch: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"PATCH\" }),\n        delete: <T>(path: string, options?: RequestOptions) =>\n            request<T>(path, { ...options, method: \"DELETE\" }),\n        blob: (path: string, options?: RequestOptions) =>\n            run<Blob>(path, { ...options }, (response) => response.blob()),\n        arrayBuffer: (path: string, options?: RequestOptions) =>\n            run<ArrayBuffer>(path, { ...options }, (response) => response.arrayBuffer()),\n        upload,\n        url: (path: string, params?: RequestOptions[\"params\"]) =>\n            buildApiUrl(config.baseURL, path, { prefix: config.prefix, params }),\n    };\n}\n"],"mappings":"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"}

package/dist/http/credential-scope.cjs

@@ -1,2 +1,2 @@
-const e=require("../utils/dev-mode.cjs");var t=new Set;function n(e){try{return new URL(e,globalThis.location?.href).origin}catch{return null}}function r(e,t,r=[]){let i=n(e);return i===null||i===n(t)||r.some(e=>n(e)===i)}function i(r,i,a=`Authorization`){if(!e.isDevBuild())return;let o=n(r);if(o===null)return;let s=`${a} ${o}`;t.has(s)||(t.add(s),console.warn(`[tempest-react-sdk] ${a} was not sent to ${o}: the credential is scoped to ${n(i)??i}. Add the origin to trustedOrigins if it should receive the token.`))}exports.isTrustedCredentialTarget=r,exports.reportSuppressedCredential=i;
+const e=require("../utils/dev-mode.cjs");var t=new Set,n=`http://relative.invalid`;function r(e){try{return new URL(e,globalThis.location?.href).origin}catch{return null}}function i(e){let t=globalThis.document?.baseURI??globalThis.location?.href;if(t!==void 0)try{return new URL(e,t).origin}catch{return`invalid`}try{return new URL(e).origin}catch{try{return new URL(e,n),`relative`}catch{return`invalid`}}}function a(e){try{return new URL(e,globalThis.document?.baseURI??globalThis.location?.href).href}catch{return null}}function o(e,t,n=[]){let a=i(e);return a===`relative`?!0:a===`invalid`||a===`null`?!1:a===r(t)||n.some(e=>r(e)===a)}function s(n,i,a=`Authorization`){if(!e.isDevBuild())return;let o=r(n);if(o===null)return;let s=`${a} ${o}`;t.has(s)||(t.add(s),console.warn(`[tempest-react-sdk] ${a} was not sent to ${o}: the credential is scoped to ${r(i)??i}. Add the origin to trustedOrigins if it should receive the token.`))}exports.isTrustedCredentialTarget=o,exports.reportSuppressedCredential=s,exports.resolveRequestUrl=a;
 //# sourceMappingURL=credential-scope.cjs.map

package/dist/http/credential-scope.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"credential-scope.cjs","names":["isDevBuild","require_dev_mode","reported","originOf","url","isTrustedCredentialTarget","targetOrigin","target","reference","trustedOrigins","origin","reportSuppressedCredential","key","header"],"sources":["../../src/http/credential-scope.ts"],"sourcesContent":["import { isDevBuild } from \"../utils/dev-mode\";\n\n/**\n * Origins already reported by {@link reportSuppressedCredential}, so a chunked\n * upload warns once instead of once per chunk.\n */\nconst reported = new Set<string>();\n\n/**\n * The origin a URL resolves to, or `null` when it has none to compare.\n *\n * Relative values resolve against the document, because that is what they mean\n * everywhere else in the SDK: an `endpoint` of `\"/api/uploads\"` and a `baseURL`\n * of `\"/api\"` are the shape you get behind a dev-server or a reverse proxy, and\n * both name the page's own origin. Comparing a resolved absolute target against\n * an unresolved relative reference is how the first draft of this function\n * withheld the credential from every client configured that way.\n *\n * `null` is reserved for the case with genuinely nothing to compare: a relative\n * URL outside a browsing context, where there is no document to resolve against.\n *\n * @param url - Absolute or relative URL.\n * @returns The origin, or `null` when it cannot be resolved.\n */\nfunction originOf(url: string): string | null {\n    try {\n        return new URL(url, globalThis.location?.href).origin;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Whether a request to `target` may carry the caller's credential.\n *\n * The SDK writes `Authorization: Bearer` in three places, and until 0.66.0 none\n * of them looked at where the request was going. That is only safe while every\n * target URL is written by the app: a resumable upload takes its URL from the\n * server's `Location` header, and `createApiClient` lets an absolute path\n * override `baseURL` entirely, so a URL arriving over the network could decide\n * which origin received the token — and the file bytes with it.\n *\n * Handing an upload off to object storage on another host is ordinary `tus`\n * deployment, not an attack, which is exactly why the credential must be scoped\n * rather than the request blocked: the upload still goes through, it just goes\n * without the API's bearer token.\n *\n * Both sides are resolved against the document first, so a relative `baseURL`\n * or `endpoint` — the shape behind a dev-server or reverse proxy — compares\n * equal to the absolute URL the request actually goes to. Outside a browsing\n * context a relative target resolves to nothing and is allowed: there is no\n * origin for it to cross.\n *\n * @param target - The URL the request is about to go to.\n * @param reference - The origin the credential belongs to, normally the\n *     client's `baseURL` or the upload `endpoint`.\n * @param trustedOrigins - Extra origins the app declared, for the legitimate\n *     second host: a CDN, a signed upload endpoint.\n * @returns Whether the credential may be attached.\n *\n * @example\n * isTrustedCredentialTarget(\"https://api.acme.com/me\", \"https://api.acme.com\");\n * // true\n * isTrustedCredentialTarget(\"https://cdn.other/u/1\", \"https://api.acme.com\");\n * // false\n */\nexport function isTrustedCredentialTarget(\n    target: string,\n    reference: string,\n    trustedOrigins: readonly string[] = [],\n): boolean {\n    const targetOrigin = originOf(target);\n    if (targetOrigin === null) return true;\n    if (targetOrigin === originOf(reference)) return true;\n    return trustedOrigins.some((origin) => originOf(origin) === targetOrigin);\n}\n\n/**\n * Say once, in a development build, that a credential was withheld.\n *\n * Without it the symptom is a `401` (or, for the CSRF header, a `403`) from a\n * host the developer never typed, and nothing in the app's code mentions the\n * origin that produced it. Keyed by credential and target origin, so a\n * hundred-chunk upload reports one line per header it withheld.\n *\n * Silent in production for the same reason {@link parseResponse} is: the origin\n * an app talks to is not something to print into a user's console or ship to an\n * error tracker.\n *\n * @param target - The URL whose request went out unauthenticated.\n * @param reference - The origin the credential was scoped to.\n * @param header - The header that was withheld. Default `\"Authorization\"`.\n */\nexport function reportSuppressedCredential(\n    target: string,\n    reference: string,\n    header = \"Authorization\",\n): void {\n    if (!isDevBuild()) return;\n    const targetOrigin = originOf(target);\n    if (targetOrigin === null) return;\n    const key = `${header} ${targetOrigin}`;\n    if (reported.has(key)) return;\n    reported.add(key);\n    console.warn(\n        `[tempest-react-sdk] ${header} was not sent to ${targetOrigin}: the credential is scoped to ${originOf(reference) ?? reference}. Add the origin to trustedOrigins if it should receive the token.`,\n    );\n}\n\n/**\n * Forget which origins were already reported.\n *\n * Exported for tests, which assert the once-per-origin behaviour and would\n * otherwise leak state between cases.\n */\nexport function resetSuppressedCredentialReports(): void {\n    reported.clear();\n}\n"],"mappings":"A,yCAMA,IAAME,EAAW,IAAI,IAkBrB,SAASC,EAAS,EAA4B,CAC1C,GAAI,CACA,OAAO,IAAI,IAAIC,EAAK,WAAW,UAAU,IAAI,CAAC,CAAC,MACnD,MAAQ,CACJ,OAAO,IACX,CACJ,CAoCA,SAAgBC,EACZ,EACA,EACA,EAAoC,CAAC,EAC9B,CACP,IAAMC,EAAeH,EAASI,CAAM,EAGpC,OAFID,IAAiB,MACjBA,IAAiBH,EAASK,CAAS,GAChCC,EAAe,KAAM,GAAWN,EAASO,CAAM,IAAMJ,CAAY,CAC5E,CAkBA,SAAgBK,EACZ,EACA,EACA,EAAS,gBACL,CACJ,GAAI,CAACX,EAAAA,WAAW,EAAG,OACnB,IAAMM,EAAeH,EAASI,CAAM,EACpC,GAAID,IAAiB,KAAM,OAC3B,IAAMM,EAAM,GAAGC,EAAO,GAAGP,IACrBJ,EAAS,IAAIU,CAAG,IACpBV,EAAS,IAAIU,CAAG,EAChB,QAAQ,KACJ,uBAAuBC,EAAO,mBAAmBP,EAAa,gCAAgCH,EAASK,CAAS,GAAKA,EAAU,mEACnI,EACJ,C"}
+{"version":3,"file":"credential-scope.cjs","names":["isDevBuild","require_dev_mode","reported","DETACHED_BASE","originOf","url","targetOriginOf","base","target","resolveRequestUrl","isTrustedCredentialTarget","targetOrigin","reference","trustedOrigins","origin","reportSuppressedCredential","key","header"],"sources":["../../src/http/credential-scope.ts"],"sourcesContent":["import { isDevBuild } from \"../utils/dev-mode\";\n\n/**\n * Origins already reported by {@link reportSuppressedCredential}, so a chunked\n * upload warns once instead of once per chunk.\n */\nconst reported = new Set<string>();\n\n/**\n * A base no real request resolves against, used only to tell a relative\n * reference from one that does not parse when there is no document at all.\n */\nconst DETACHED_BASE = \"http://relative.invalid\";\n\n/**\n * The origin a credential reference names, or `null` when it has none.\n *\n * A reference — `baseURL`, `endpoint`, `credentialOrigin`, a trusted origin —\n * is the trust anchor, so a relative one resolves against the page's own\n * address (`location.href`), never against a `<base href>`: an injected\n * `<base>` must not be able to move the anchor onto its own host.\n *\n * Relative references are the shape you get behind a dev-server or a reverse\n * proxy, and they name the page's own origin. Comparing a resolved absolute\n * target against an unresolved relative reference is how the first draft of\n * this function withheld the credential from every client configured that way.\n *\n * @param url - Absolute or relative URL.\n * @returns The origin, or `null` when it cannot be resolved.\n */\nfunction originOf(url: string): string | null {\n    try {\n        return new URL(url, globalThis.location?.href).origin;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Where a request to `target` actually goes, as the transport resolves it.\n *\n * `XMLHttpRequest.open()` and `fetch()` resolve a relative URL against the\n * document's base URL (`document.baseURI`), which a `<base href>` changes and\n * `location.href` does not. Until 0.82.0 the target was resolved against the\n * page's address, so under an injected `<base>` a relative `url` and a relative\n * `credentialOrigin` compared equal while the request went to the `<base>` host\n * with the token (#530). A worker has no document; its base is its location.\n *\n * Three answers, because the caller treats them differently:\n *\n * - an origin — compare it;\n * - `\"relative\"` — a relative target with nothing to resolve it against\n *   (outside any browsing context): there is no origin for it to cross;\n * - `\"invalid\"` — a target that does not parse. Refused: the check used to\n *   fail open here, so a custom `fetcher` that accepts such a string received\n *   the credential (#530).\n *\n * An opaque origin (`data:`, `file:`) comes back as the string `\"null\"`, which\n * the caller also refuses: two opaque origins are never the same origin, yet\n * `\"null\" === \"null\"`.\n *\n * @param target - The URL the request is about to go to.\n * @returns The origin, `\"relative\"` or `\"invalid\"`.\n */\nfunction targetOriginOf(target: string): string {\n    const base = globalThis.document?.baseURI ?? globalThis.location?.href;\n    if (base !== undefined) {\n        try {\n            return new URL(target, base).origin;\n        } catch {\n            return \"invalid\";\n        }\n    }\n    try {\n        return new URL(target).origin;\n    } catch {\n        try {\n            new URL(target, DETACHED_BASE);\n            return \"relative\";\n        } catch {\n            return \"invalid\";\n        }\n    }\n}\n\n/**\n * Resolve a URL the way the transport will, against the document base URL.\n *\n * Exported for the resumable upload, which has to resolve a relative tus\n * `Location` against the creation endpoint as the request actually went out.\n *\n * @param url - Absolute or relative URL.\n * @returns The absolute URL, or `null` when it does not resolve.\n */\nexport function resolveRequestUrl(url: string): string | null {\n    try {\n        return new URL(url, globalThis.document?.baseURI ?? globalThis.location?.href).href;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Whether a request to `target` may carry the caller's credential.\n *\n * The SDK writes `Authorization: Bearer` in three places, and until 0.66.0 none\n * of them looked at where the request was going. That is only safe while every\n * target URL is written by the app: a resumable upload takes its URL from the\n * server's `Location` header, and `createApiClient` lets an absolute path\n * override `baseURL` entirely, so a URL arriving over the network could decide\n * which origin received the token — and the file bytes with it.\n *\n * Handing an upload off to object storage on another host is ordinary `tus`\n * deployment, not an attack, which is exactly why the credential must be scoped\n * rather than the request blocked: the upload still goes through, it just goes\n * without the API's bearer token.\n *\n * Both sides are resolved first, so a relative `baseURL` or `endpoint` — the\n * shape behind a dev-server or reverse proxy — compares equal to the absolute\n * URL the request actually goes to. The target resolves against the document\n * base URL, where the transport sends it; the reference against the page's\n * own address, which a `<base href>` cannot move. Outside a browsing context a\n * relative target is allowed — there is no origin for it to cross — and a\n * target that does not parse is refused rather than trusted.\n *\n * @param target - The URL the request is about to go to.\n * @param reference - The origin the credential belongs to, normally the\n *     client's `baseURL` or the upload `endpoint`.\n * @param trustedOrigins - Extra origins the app declared, for the legitimate\n *     second host: a CDN, a signed upload endpoint.\n * @returns Whether the credential may be attached.\n *\n * @example\n * isTrustedCredentialTarget(\"https://api.acme.com/me\", \"https://api.acme.com\");\n * // true\n * isTrustedCredentialTarget(\"https://cdn.other/u/1\", \"https://api.acme.com\");\n * // false\n */\nexport function isTrustedCredentialTarget(\n    target: string,\n    reference: string,\n    trustedOrigins: readonly string[] = [],\n): boolean {\n    const targetOrigin = targetOriginOf(target);\n    if (targetOrigin === \"relative\") return true;\n    if (targetOrigin === \"invalid\" || targetOrigin === \"null\") return false;\n    if (targetOrigin === originOf(reference)) return true;\n    return trustedOrigins.some((origin) => originOf(origin) === targetOrigin);\n}\n\n/**\n * Say once, in a development build, that a credential was withheld.\n *\n * Without it the symptom is a `401` (or, for the CSRF header, a `403`) from a\n * host the developer never typed, and nothing in the app's code mentions the\n * origin that produced it. Keyed by credential and target origin, so a\n * hundred-chunk upload reports one line per header it withheld.\n *\n * Silent in production for the same reason {@link parseResponse} is: the origin\n * an app talks to is not something to print into a user's console or ship to an\n * error tracker.\n *\n * @param target - The URL whose request went out unauthenticated.\n * @param reference - The origin the credential was scoped to.\n * @param header - The header that was withheld. Default `\"Authorization\"`.\n */\nexport function reportSuppressedCredential(\n    target: string,\n    reference: string,\n    header = \"Authorization\",\n): void {\n    if (!isDevBuild()) return;\n    const targetOrigin = originOf(target);\n    if (targetOrigin === null) return;\n    const key = `${header} ${targetOrigin}`;\n    if (reported.has(key)) return;\n    reported.add(key);\n    console.warn(\n        `[tempest-react-sdk] ${header} was not sent to ${targetOrigin}: the credential is scoped to ${originOf(reference) ?? reference}. Add the origin to trustedOrigins if it should receive the token.`,\n    );\n}\n\n/**\n * Forget which origins were already reported.\n *\n * Exported for tests, which assert the once-per-origin behaviour and would\n * otherwise leak state between cases.\n */\nexport function resetSuppressedCredentialReports(): void {\n    reported.clear();\n}\n"],"mappings":"A,yCAMA,IAAME,EAAW,IAAI,IAMfC,EAAgB,0BAkBtB,SAASC,EAAS,EAA4B,CAC1C,GAAI,CACA,OAAO,IAAI,IAAIC,EAAK,WAAW,UAAU,IAAI,CAAC,CAAC,MACnD,MAAQ,CACJ,OAAO,IACX,CACJ,CA4BA,SAASC,EAAe,EAAwB,CAC5C,IAAMC,EAAO,WAAW,UAAU,SAAW,WAAW,UAAU,KAClE,GAAIA,IAAS,IAAA,GACT,GAAI,CACA,OAAO,IAAI,IAAIC,EAAQD,CAAI,CAAC,CAAC,MACjC,MAAQ,CACJ,MAAO,SACX,CAEJ,GAAI,CACA,OAAO,IAAI,IAAIC,CAAM,CAAC,CAAC,MAC3B,MAAQ,CACJ,GAAI,CAEA,OADA,IAAI,IAAIA,EAAQL,CAAa,EACtB,UACX,MAAQ,CACJ,MAAO,SACX,CACJ,CACJ,CAWA,SAAgBM,EAAkB,EAA4B,CAC1D,GAAI,CACA,OAAO,IAAI,IAAIJ,EAAK,WAAW,UAAU,SAAW,WAAW,UAAU,IAAI,CAAC,CAAC,IACnF,MAAQ,CACJ,OAAO,IACX,CACJ,CAsCA,SAAgBK,EACZ,EACA,EACA,EAAoC,CAAC,EAC9B,CACP,IAAMC,EAAeL,EAAeE,CAAM,EAI1C,OAHIG,IAAiB,WAAmB,GACpCA,IAAiB,WAAaA,IAAiB,OAAe,GAC9DA,IAAiBP,EAASQ,CAAS,GAChCC,EAAe,KAAM,GAAWT,EAASU,CAAM,IAAMH,CAAY,CAC5E,CAkBA,SAAgBI,EACZ,EACA,EACA,EAAS,gBACL,CACJ,GAAI,CAACf,EAAAA,WAAW,EAAG,OACnB,IAAMW,EAAeP,EAASI,CAAM,EACpC,GAAIG,IAAiB,KAAM,OAC3B,IAAMK,EAAM,GAAGC,EAAO,GAAGN,IACrBT,EAAS,IAAIc,CAAG,IACpBd,EAAS,IAAIc,CAAG,EAChB,QAAQ,KACJ,uBAAuBC,EAAO,mBAAmBN,EAAa,gCAAgCP,EAASQ,CAAS,GAAKA,EAAU,mEACnI,EACJ,C"}

package/dist/http/credential-scope.js

@@ -1,25 +1,49 @@
 import { isDevBuild as e } from "../utils/dev-mode.js";
 //#region src/http/credential-scope.ts
-var t = /* @__PURE__ */ new Set();
-function n(e) {
+var t = /* @__PURE__ */ new Set(), n = "http://relative.invalid";
+function r(e) {
 	try {
 		return new URL(e, globalThis.location?.href).origin;
 	} catch {
 		return null;
 	}
 }
-function r(e, t, r = []) {
-	let i = n(e);
-	return i === null || i === n(t) || r.some((e) => n(e) === i);
+function i(e) {
+	let t = globalThis.document?.baseURI ?? globalThis.location?.href;
+	if (t !== void 0) try {
+		return new URL(e, t).origin;
+	} catch {
+		return "invalid";
+	}
+	try {
+		return new URL(e).origin;
+	} catch {
+		try {
+			return new URL(e, n), "relative";
+		} catch {
+			return "invalid";
+		}
+	}
+}
+function a(e) {
+	try {
+		return new URL(e, globalThis.document?.baseURI ?? globalThis.location?.href).href;
+	} catch {
+		return null;
+	}
+}
+function o(e, t, n = []) {
+	let a = i(e);
+	return a === "relative" ? !0 : a === "invalid" || a === "null" ? !1 : a === r(t) || n.some((e) => r(e) === a);
 }
-function i(r, i, a = "Authorization") {
+function s(n, i, a = "Authorization") {
 	if (!e()) return;
-	let o = n(r);
+	let o = r(n);
 	if (o === null) return;
 	let s = `${a} ${o}`;
-	t.has(s) || (t.add(s), console.warn(`[tempest-react-sdk] ${a} was not sent to ${o}: the credential is scoped to ${n(i) ?? i}. Add the origin to trustedOrigins if it should receive the token.`));
+	t.has(s) || (t.add(s), console.warn(`[tempest-react-sdk] ${a} was not sent to ${o}: the credential is scoped to ${r(i) ?? i}. Add the origin to trustedOrigins if it should receive the token.`));
 }
 //#endregion
-export { r as isTrustedCredentialTarget, i as reportSuppressedCredential };
+export { o as isTrustedCredentialTarget, s as reportSuppressedCredential, a as resolveRequestUrl };
 
 //# sourceMappingURL=credential-scope.js.map

package/dist/http/credential-scope.js.map

@@ -1 +1 @@
-{"version":3,"file":"credential-scope.js","names":["reported","originOf","url","isTrustedCredentialTarget","targetOrigin","target","reference","trustedOrigins","origin","reportSuppressedCredential","isDevBuild","key","header"],"sources":["../../src/http/credential-scope.ts"],"sourcesContent":["import { isDevBuild } from \"../utils/dev-mode\";\n\n/**\n * Origins already reported by {@link reportSuppressedCredential}, so a chunked\n * upload warns once instead of once per chunk.\n */\nconst reported = new Set<string>();\n\n/**\n * The origin a URL resolves to, or `null` when it has none to compare.\n *\n * Relative values resolve against the document, because that is what they mean\n * everywhere else in the SDK: an `endpoint` of `\"/api/uploads\"` and a `baseURL`\n * of `\"/api\"` are the shape you get behind a dev-server or a reverse proxy, and\n * both name the page's own origin. Comparing a resolved absolute target against\n * an unresolved relative reference is how the first draft of this function\n * withheld the credential from every client configured that way.\n *\n * `null` is reserved for the case with genuinely nothing to compare: a relative\n * URL outside a browsing context, where there is no document to resolve against.\n *\n * @param url - Absolute or relative URL.\n * @returns The origin, or `null` when it cannot be resolved.\n */\nfunction originOf(url: string): string | null {\n    try {\n        return new URL(url, globalThis.location?.href).origin;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Whether a request to `target` may carry the caller's credential.\n *\n * The SDK writes `Authorization: Bearer` in three places, and until 0.66.0 none\n * of them looked at where the request was going. That is only safe while every\n * target URL is written by the app: a resumable upload takes its URL from the\n * server's `Location` header, and `createApiClient` lets an absolute path\n * override `baseURL` entirely, so a URL arriving over the network could decide\n * which origin received the token — and the file bytes with it.\n *\n * Handing an upload off to object storage on another host is ordinary `tus`\n * deployment, not an attack, which is exactly why the credential must be scoped\n * rather than the request blocked: the upload still goes through, it just goes\n * without the API's bearer token.\n *\n * Both sides are resolved against the document first, so a relative `baseURL`\n * or `endpoint` — the shape behind a dev-server or reverse proxy — compares\n * equal to the absolute URL the request actually goes to. Outside a browsing\n * context a relative target resolves to nothing and is allowed: there is no\n * origin for it to cross.\n *\n * @param target - The URL the request is about to go to.\n * @param reference - The origin the credential belongs to, normally the\n *     client's `baseURL` or the upload `endpoint`.\n * @param trustedOrigins - Extra origins the app declared, for the legitimate\n *     second host: a CDN, a signed upload endpoint.\n * @returns Whether the credential may be attached.\n *\n * @example\n * isTrustedCredentialTarget(\"https://api.acme.com/me\", \"https://api.acme.com\");\n * // true\n * isTrustedCredentialTarget(\"https://cdn.other/u/1\", \"https://api.acme.com\");\n * // false\n */\nexport function isTrustedCredentialTarget(\n    target: string,\n    reference: string,\n    trustedOrigins: readonly string[] = [],\n): boolean {\n    const targetOrigin = originOf(target);\n    if (targetOrigin === null) return true;\n    if (targetOrigin === originOf(reference)) return true;\n    return trustedOrigins.some((origin) => originOf(origin) === targetOrigin);\n}\n\n/**\n * Say once, in a development build, that a credential was withheld.\n *\n * Without it the symptom is a `401` (or, for the CSRF header, a `403`) from a\n * host the developer never typed, and nothing in the app's code mentions the\n * origin that produced it. Keyed by credential and target origin, so a\n * hundred-chunk upload reports one line per header it withheld.\n *\n * Silent in production for the same reason {@link parseResponse} is: the origin\n * an app talks to is not something to print into a user's console or ship to an\n * error tracker.\n *\n * @param target - The URL whose request went out unauthenticated.\n * @param reference - The origin the credential was scoped to.\n * @param header - The header that was withheld. Default `\"Authorization\"`.\n */\nexport function reportSuppressedCredential(\n    target: string,\n    reference: string,\n    header = \"Authorization\",\n): void {\n    if (!isDevBuild()) return;\n    const targetOrigin = originOf(target);\n    if (targetOrigin === null) return;\n    const key = `${header} ${targetOrigin}`;\n    if (reported.has(key)) return;\n    reported.add(key);\n    console.warn(\n        `[tempest-react-sdk] ${header} was not sent to ${targetOrigin}: the credential is scoped to ${originOf(reference) ?? reference}. Add the origin to trustedOrigins if it should receive the token.`,\n    );\n}\n\n/**\n * Forget which origins were already reported.\n *\n * Exported for tests, which assert the once-per-origin behaviour and would\n * otherwise leak state between cases.\n */\nexport function resetSuppressedCredentialReports(): void {\n    reported.clear();\n}\n"],"mappings":";;AAMA,IAAMA,oBAAW,IAAI,IAAY;AAkBjC,SAASC,EAAS,GAA4B;CAC1C,IAAI;EACA,OAAO,IAAI,IAAIC,GAAK,WAAW,UAAU,IAAI,CAAC,CAAC;CACnD,QAAQ;EACJ,OAAO;CACX;AACJ;AAoCA,SAAgBC,EACZ,GACA,GACA,IAAoC,CAAC,GAC9B;CACP,IAAMC,IAAeH,EAASI,CAAM;CAGpC,OAFID,MAAiB,QACjBA,MAAiBH,EAASK,CAAS,KAChCC,EAAe,MAAM,MAAWN,EAASO,CAAM,MAAMJ,CAAY;AAC5E;AAkBA,SAAgBK,EACZ,GACA,GACA,IAAS,iBACL;CACJ,IAAI,CAACC,EAAW,GAAG;CACnB,IAAMN,IAAeH,EAASI,CAAM;CACpC,IAAID,MAAiB,MAAM;CAC3B,IAAMO,IAAM,GAAGC,EAAO,GAAGR;CACzB,AAAIJ,EAAS,IAAIW,CAAG,MACpBX,EAAS,IAAIW,CAAG,GAChB,QAAQ,KACJ,uBAAuBC,EAAO,mBAAmBR,EAAa,gCAAgCH,EAASK,CAAS,KAAKA,EAAU,mEACnI;AACJ"}
+{"version":3,"file":"credential-scope.js","names":["reported","DETACHED_BASE","originOf","url","targetOriginOf","base","target","resolveRequestUrl","isTrustedCredentialTarget","targetOrigin","reference","trustedOrigins","origin","reportSuppressedCredential","isDevBuild","key","header"],"sources":["../../src/http/credential-scope.ts"],"sourcesContent":["import { isDevBuild } from \"../utils/dev-mode\";\n\n/**\n * Origins already reported by {@link reportSuppressedCredential}, so a chunked\n * upload warns once instead of once per chunk.\n */\nconst reported = new Set<string>();\n\n/**\n * A base no real request resolves against, used only to tell a relative\n * reference from one that does not parse when there is no document at all.\n */\nconst DETACHED_BASE = \"http://relative.invalid\";\n\n/**\n * The origin a credential reference names, or `null` when it has none.\n *\n * A reference — `baseURL`, `endpoint`, `credentialOrigin`, a trusted origin —\n * is the trust anchor, so a relative one resolves against the page's own\n * address (`location.href`), never against a `<base href>`: an injected\n * `<base>` must not be able to move the anchor onto its own host.\n *\n * Relative references are the shape you get behind a dev-server or a reverse\n * proxy, and they name the page's own origin. Comparing a resolved absolute\n * target against an unresolved relative reference is how the first draft of\n * this function withheld the credential from every client configured that way.\n *\n * @param url - Absolute or relative URL.\n * @returns The origin, or `null` when it cannot be resolved.\n */\nfunction originOf(url: string): string | null {\n    try {\n        return new URL(url, globalThis.location?.href).origin;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Where a request to `target` actually goes, as the transport resolves it.\n *\n * `XMLHttpRequest.open()` and `fetch()` resolve a relative URL against the\n * document's base URL (`document.baseURI`), which a `<base href>` changes and\n * `location.href` does not. Until 0.82.0 the target was resolved against the\n * page's address, so under an injected `<base>` a relative `url` and a relative\n * `credentialOrigin` compared equal while the request went to the `<base>` host\n * with the token (#530). A worker has no document; its base is its location.\n *\n * Three answers, because the caller treats them differently:\n *\n * - an origin — compare it;\n * - `\"relative\"` — a relative target with nothing to resolve it against\n *   (outside any browsing context): there is no origin for it to cross;\n * - `\"invalid\"` — a target that does not parse. Refused: the check used to\n *   fail open here, so a custom `fetcher` that accepts such a string received\n *   the credential (#530).\n *\n * An opaque origin (`data:`, `file:`) comes back as the string `\"null\"`, which\n * the caller also refuses: two opaque origins are never the same origin, yet\n * `\"null\" === \"null\"`.\n *\n * @param target - The URL the request is about to go to.\n * @returns The origin, `\"relative\"` or `\"invalid\"`.\n */\nfunction targetOriginOf(target: string): string {\n    const base = globalThis.document?.baseURI ?? globalThis.location?.href;\n    if (base !== undefined) {\n        try {\n            return new URL(target, base).origin;\n        } catch {\n            return \"invalid\";\n        }\n    }\n    try {\n        return new URL(target).origin;\n    } catch {\n        try {\n            new URL(target, DETACHED_BASE);\n            return \"relative\";\n        } catch {\n            return \"invalid\";\n        }\n    }\n}\n\n/**\n * Resolve a URL the way the transport will, against the document base URL.\n *\n * Exported for the resumable upload, which has to resolve a relative tus\n * `Location` against the creation endpoint as the request actually went out.\n *\n * @param url - Absolute or relative URL.\n * @returns The absolute URL, or `null` when it does not resolve.\n */\nexport function resolveRequestUrl(url: string): string | null {\n    try {\n        return new URL(url, globalThis.document?.baseURI ?? globalThis.location?.href).href;\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Whether a request to `target` may carry the caller's credential.\n *\n * The SDK writes `Authorization: Bearer` in three places, and until 0.66.0 none\n * of them looked at where the request was going. That is only safe while every\n * target URL is written by the app: a resumable upload takes its URL from the\n * server's `Location` header, and `createApiClient` lets an absolute path\n * override `baseURL` entirely, so a URL arriving over the network could decide\n * which origin received the token — and the file bytes with it.\n *\n * Handing an upload off to object storage on another host is ordinary `tus`\n * deployment, not an attack, which is exactly why the credential must be scoped\n * rather than the request blocked: the upload still goes through, it just goes\n * without the API's bearer token.\n *\n * Both sides are resolved first, so a relative `baseURL` or `endpoint` — the\n * shape behind a dev-server or reverse proxy — compares equal to the absolute\n * URL the request actually goes to. The target resolves against the document\n * base URL, where the transport sends it; the reference against the page's\n * own address, which a `<base href>` cannot move. Outside a browsing context a\n * relative target is allowed — there is no origin for it to cross — and a\n * target that does not parse is refused rather than trusted.\n *\n * @param target - The URL the request is about to go to.\n * @param reference - The origin the credential belongs to, normally the\n *     client's `baseURL` or the upload `endpoint`.\n * @param trustedOrigins - Extra origins the app declared, for the legitimate\n *     second host: a CDN, a signed upload endpoint.\n * @returns Whether the credential may be attached.\n *\n * @example\n * isTrustedCredentialTarget(\"https://api.acme.com/me\", \"https://api.acme.com\");\n * // true\n * isTrustedCredentialTarget(\"https://cdn.other/u/1\", \"https://api.acme.com\");\n * // false\n */\nexport function isTrustedCredentialTarget(\n    target: string,\n    reference: string,\n    trustedOrigins: readonly string[] = [],\n): boolean {\n    const targetOrigin = targetOriginOf(target);\n    if (targetOrigin === \"relative\") return true;\n    if (targetOrigin === \"invalid\" || targetOrigin === \"null\") return false;\n    if (targetOrigin === originOf(reference)) return true;\n    return trustedOrigins.some((origin) => originOf(origin) === targetOrigin);\n}\n\n/**\n * Say once, in a development build, that a credential was withheld.\n *\n * Without it the symptom is a `401` (or, for the CSRF header, a `403`) from a\n * host the developer never typed, and nothing in the app's code mentions the\n * origin that produced it. Keyed by credential and target origin, so a\n * hundred-chunk upload reports one line per header it withheld.\n *\n * Silent in production for the same reason {@link parseResponse} is: the origin\n * an app talks to is not something to print into a user's console or ship to an\n * error tracker.\n *\n * @param target - The URL whose request went out unauthenticated.\n * @param reference - The origin the credential was scoped to.\n * @param header - The header that was withheld. Default `\"Authorization\"`.\n */\nexport function reportSuppressedCredential(\n    target: string,\n    reference: string,\n    header = \"Authorization\",\n): void {\n    if (!isDevBuild()) return;\n    const targetOrigin = originOf(target);\n    if (targetOrigin === null) return;\n    const key = `${header} ${targetOrigin}`;\n    if (reported.has(key)) return;\n    reported.add(key);\n    console.warn(\n        `[tempest-react-sdk] ${header} was not sent to ${targetOrigin}: the credential is scoped to ${originOf(reference) ?? reference}. Add the origin to trustedOrigins if it should receive the token.`,\n    );\n}\n\n/**\n * Forget which origins were already reported.\n *\n * Exported for tests, which assert the once-per-origin behaviour and would\n * otherwise leak state between cases.\n */\nexport function resetSuppressedCredentialReports(): void {\n    reported.clear();\n}\n"],"mappings":";;AAMA,IAAMA,oBAAW,IAAI,IAAY,GAM3BC,IAAgB;AAkBtB,SAASC,EAAS,GAA4B;CAC1C,IAAI;EACA,OAAO,IAAI,IAAIC,GAAK,WAAW,UAAU,IAAI,CAAC,CAAC;CACnD,QAAQ;EACJ,OAAO;CACX;AACJ;AA4BA,SAASC,EAAe,GAAwB;CAC5C,IAAMC,IAAO,WAAW,UAAU,WAAW,WAAW,UAAU;CAClE,IAAIA,MAAS,KAAA,GACT,IAAI;EACA,OAAO,IAAI,IAAIC,GAAQD,CAAI,CAAC,CAAC;CACjC,QAAQ;EACJ,OAAO;CACX;CAEJ,IAAI;EACA,OAAO,IAAI,IAAIC,CAAM,CAAC,CAAC;CAC3B,QAAQ;EACJ,IAAI;GAEA,OADA,IAAI,IAAIA,GAAQL,CAAa,GACtB;EACX,QAAQ;GACJ,OAAO;EACX;CACJ;AACJ;AAWA,SAAgBM,EAAkB,GAA4B;CAC1D,IAAI;EACA,OAAO,IAAI,IAAIJ,GAAK,WAAW,UAAU,WAAW,WAAW,UAAU,IAAI,CAAC,CAAC;CACnF,QAAQ;EACJ,OAAO;CACX;AACJ;AAsCA,SAAgBK,EACZ,GACA,GACA,IAAoC,CAAC,GAC9B;CACP,IAAMC,IAAeL,EAAeE,CAAM;CAI1C,OAHIG,MAAiB,aAAmB,KACpCA,MAAiB,aAAaA,MAAiB,SAAe,KAC9DA,MAAiBP,EAASQ,CAAS,KAChCC,EAAe,MAAM,MAAWT,EAASU,CAAM,MAAMH,CAAY;AAC5E;AAkBA,SAAgBI,EACZ,GACA,GACA,IAAS,iBACL;CACJ,IAAI,CAACC,EAAW,GAAG;CACnB,IAAML,IAAeP,EAASI,CAAM;CACpC,IAAIG,MAAiB,MAAM;CAC3B,IAAMM,IAAM,GAAGC,EAAO,GAAGP;CACzB,AAAIT,EAAS,IAAIe,CAAG,MACpBf,EAAS,IAAIe,CAAG,GAChB,QAAQ,KACJ,uBAAuBC,EAAO,mBAAmBP,EAAa,gCAAgCP,EAASQ,CAAS,KAAKA,EAAU,mEACnI;AACJ"}