@selvajs/compute 5.0.1 → 5.1.0-beta.0

package/dist/{handle-files-D-4X4Uh_.js → handle-files-CzqBN3MP.js}

@@ -1,72 +1,3 @@
-// src/core/compute-fetch/retry.ts
-const DEFAULT_RETRY = {
-	attempts: 0,
-	baseDelayMs: 500,
-	maxDelayMs: 3e4,
-	retryOn429: true
-};
-const RETRYABLE_STATUS = /* @__PURE__ */ new Set([
-	502,
-	503,
-	504
-]);
-/**
-* Ceiling on a server-sent `Retry-After` wait. The server's window outranks
-* `RetryPolicy.maxDelayMs` (retrying sooner all but guarantees another 429), but a bad or hostile
-* header must not park the client for minutes. A `maxDelayMs` above this cap raises it.
-*/
-const RETRY_AFTER_CAP_MS = 6e4;
-function resolveRetryPolicy(policy) {
-	if (!policy) return DEFAULT_RETRY;
-	return {
-		attempts: policy.attempts ?? DEFAULT_RETRY.attempts,
-		baseDelayMs: policy.baseDelayMs ?? DEFAULT_RETRY.baseDelayMs,
-		maxDelayMs: policy.maxDelayMs ?? DEFAULT_RETRY.maxDelayMs,
-		retryOn429: policy.retryOn429 ?? DEFAULT_RETRY.retryOn429
-	};
-}
-function isRetryableStatus(status, policy) {
-	return RETRYABLE_STATUS.has(status) || policy.retryOn429 && status === 429;
-}
-/** Delay before the next attempt: the server's `Retry-After` when it sent one, else backoff. */
-function retryDelay(retryAfter, attempt, policy) {
-	const retryAfterMs = parseRetryAfter(retryAfter);
-	return retryAfterMs === null ? backoffDelay(attempt, policy) : Math.min(retryAfterMs, Math.max(policy.maxDelayMs, RETRY_AFTER_CAP_MS));
-}
-/** A `Retry-After` value (seconds or HTTP-date) in ms; null when missing or unparseable. */
-function parseRetryAfter(headerValue) {
-	if (!headerValue) return null;
-	const seconds = Number(headerValue);
-	if (Number.isFinite(seconds) && seconds >= 0) return seconds * 1e3;
-	const dateMs = Date.parse(headerValue);
-	if (Number.isFinite(dateMs)) {
-		const delta = dateMs - Date.now();
-		return delta > 0 ? delta : 0;
-	}
-	return null;
-}
-function backoffDelay(attempt, policy) {
-	const exponential = policy.baseDelayMs * Math.pow(2, attempt);
-	const jitter = Math.random() * policy.baseDelayMs;
-	return Math.min(exponential + jitter, policy.maxDelayMs);
-}
-function sleep(ms, signal) {
-	return new Promise((resolve, reject) => {
-		if (signal?.aborted) {
-			reject(new DOMException("Aborted", "AbortError"));
-			return;
-		}
-		const id = setTimeout(() => {
-			signal?.removeEventListener("abort", onAbort);
-			resolve();
-		}, ms);
-		const onAbort = () => {
-			clearTimeout(id);
-			reject(new DOMException("Aborted", "AbortError"));
-		};
-		signal?.addEventListener("abort", onAbort, { once: true });
-	});
-}
 // src/core/errors.ts
 const ErrorCodes = {
 	/** Connection failure, a gateway status (502/503/504), or a 2xx body cut off mid-stream. */
@@ -208,6 +139,179 @@ function setLogger(logger) {
 function enableDebugLogging() {
 	setLogger(console);
 }
+// src/core/utils/warnings.ts
+const warned = /* @__PURE__ */ new Set();
+/** Log `message` the first time `key` is seen: what it reports doesn't change per call. */
+function warnOnce(key, message) {
+	if (warned.has(key)) return;
+	warned.add(key);
+	getLogger().warn(message);
+}
+/**
+* True only in a real browser, where an API key in the config is exposed to users. jsdom defines
+* `window` too, so Node is ruled out by `process.versions.node`, and by jsdom's user-agent marker
+* for setups that hide `process`.
+*/
+function isRealBrowser() {
+	if (typeof window === "undefined") return false;
+	if (globalThis.process?.versions?.node != null) return false;
+	const nav = globalThis.navigator;
+	const userAgent = typeof nav?.userAgent === "string" ? nav.userAgent : "";
+	if (/jsdom/i.test(userAgent)) return false;
+	return true;
+}
+function warnIfClientSide(functionName, suppress) {
+	if (suppress || !isRealBrowser()) return;
+	warnOnce(`client-side:${functionName}`, `Warning: ${functionName} is running on the client side. For better performance and security, consider running this on the server side.`);
+}
+// src/core/compute-fetch/request.ts
+/** `serverUrl` as `validateServerUrl` returns it: no trailing slash. */
+function buildUrl(endpoint, serverUrl) {
+	return `${serverUrl}/${endpoint.replace(/^\/+/, "")}`;
+}
+function isLocalhost(serverUrl) {
+	const hostname = new URL(serverUrl).hostname.toLowerCase();
+	return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "[::1]";
+}
+const DEFAULT_API_KEY_HEADER = "RhinoComputeKey";
+/**
+* Caller headers plus credentials. Every request to the server builds its headers here,
+* so a liveness probe authenticates exactly like the solve it gates.
+*/
+function buildAuthHeaders(auth) {
+	return assertSendable(mergeUnder(auth.headers, credentialHeaders(auth)));
+}
+function buildHeaders(requestId, config) {
+	const headers = assertSendable(mergeUnder(config.headers, {
+		...credentialHeaders(config),
+		...sessionHeader(config.sessionId),
+		"X-Request-ID": requestId,
+		"Content-Type": "application/json"
+	}));
+	if (!config.apiKey && !config.authToken && !isLocalhost(config.serverUrl)) warnOnce(`no-auth:${config.serverUrl}`, `[Compute] Request [${requestId}] targets remote server (${config.serverUrl}) but no API key or auth token is configured. Requests may fail or be rate-limited. (warned once per server)`);
+	return headers;
+}
+/** `headers` with a JSON `Content-Type` that replaces one of any casing already there. */
+function withJsonContentType(headers) {
+	return mergeUnder(headers, { "Content-Type": "application/json" });
+}
+function credentialHeaders(auth) {
+	return {
+		...auth.authToken && { Authorization: auth.authToken },
+		...auth.apiKey && { [auth.apiKeyHeader ?? DEFAULT_API_KEY_HEADER]: auth.apiKey }
+	};
+}
+const SESSION_ID = /^[!-~]{1,128}$/;
+/**
+* Compute drops a malformed id without an error, so the request would quietly lose its routing.
+* The client and scheduler call this on entry too: by `buildHeaders` a solve has already taken a
+* slot and loaded its definition.
+*/
+function assertSessionId(sessionId) {
+	if (sessionId === void 0 || SESSION_ID.test(sessionId)) return;
+	throw new ComputeError("sessionId must be 1 to 128 characters from \"!\" to \"~\"", ErrorCodes.INVALID_CONFIG, { context: { length: sessionId.length } });
+}
+function sessionHeader(sessionId) {
+	assertSessionId(sessionId);
+	return sessionId === void 0 ? {} : { "X-Session-Id": sessionId };
+}
+/**
+* Header names are case-insensitive and fetch joins duplicates, so a caller key
+* matching a transport key in any case is dropped rather than sent alongside it.
+*/
+function mergeUnder(caller, transport) {
+	const taken = new Set(Object.keys(transport).map((name) => name.toLowerCase()));
+	const kept = Object.entries(caller ?? {}).filter(([name]) => !taken.has(name.toLowerCase()));
+	return {
+		...Object.fromEntries(kept),
+		...transport
+	};
+}
+/**
+* Left to fetch, a bad value becomes a retried TypeError that quotes it, and the value may be the
+* API key. `Headers` throws the same message, so its error is not kept as the cause.
+*/
+function assertSendable(headers) {
+	const check = new Headers();
+	for (const [name, value] of Object.entries(headers)) try {
+		check.set(name, value);
+	} catch {
+		throw new ComputeError(`Header "${name}" has an invalid name or value`, ErrorCodes.INVALID_CONFIG, { context: { header: name } });
+	}
+	return headers;
+}
+function generateRequestId() {
+	return `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
+}
+// src/core/compute-fetch/retry.ts
+const DEFAULT_RETRY = {
+	attempts: 0,
+	baseDelayMs: 500,
+	maxDelayMs: 3e4,
+	retryOn429: true
+};
+const RETRYABLE_STATUS = /* @__PURE__ */ new Set([
+	502,
+	503,
+	504
+]);
+/**
+* Ceiling on a server-sent `Retry-After` wait. The server's window outranks
+* `RetryPolicy.maxDelayMs` (retrying sooner all but guarantees another 429), but a bad or hostile
+* header must not park the client for minutes. A `maxDelayMs` above this cap raises it.
+*/
+const RETRY_AFTER_CAP_MS = 6e4;
+function resolveRetryPolicy(policy) {
+	if (!policy) return DEFAULT_RETRY;
+	return {
+		attempts: policy.attempts ?? DEFAULT_RETRY.attempts,
+		baseDelayMs: policy.baseDelayMs ?? DEFAULT_RETRY.baseDelayMs,
+		maxDelayMs: policy.maxDelayMs ?? DEFAULT_RETRY.maxDelayMs,
+		retryOn429: policy.retryOn429 ?? DEFAULT_RETRY.retryOn429
+	};
+}
+function isRetryableStatus(status, policy) {
+	return RETRYABLE_STATUS.has(status) || policy.retryOn429 && status === 429;
+}
+/** Delay before the next attempt: the server's `Retry-After` when it sent one, else backoff. */
+function retryDelay(retryAfter, attempt, policy) {
+	const retryAfterMs = parseRetryAfter(retryAfter);
+	return retryAfterMs === null ? backoffDelay(attempt, policy) : Math.min(retryAfterMs, Math.max(policy.maxDelayMs, RETRY_AFTER_CAP_MS));
+}
+/** A `Retry-After` value (seconds or HTTP-date) in ms; null when missing or unparseable. */
+function parseRetryAfter(headerValue) {
+	if (!headerValue) return null;
+	const seconds = Number(headerValue);
+	if (Number.isFinite(seconds) && seconds >= 0) return seconds * 1e3;
+	const dateMs = Date.parse(headerValue);
+	if (Number.isFinite(dateMs)) {
+		const delta = dateMs - Date.now();
+		return delta > 0 ? delta : 0;
+	}
+	return null;
+}
+function backoffDelay(attempt, policy) {
+	const exponential = policy.baseDelayMs * Math.pow(2, attempt);
+	const jitter = Math.random() * policy.baseDelayMs;
+	return Math.min(exponential + jitter, policy.maxDelayMs);
+}
+function sleep(ms, signal) {
+	return new Promise((resolve, reject) => {
+		if (signal?.aborted) {
+			reject(new DOMException("Aborted", "AbortError"));
+			return;
+		}
+		const id = setTimeout(() => {
+			signal?.removeEventListener("abort", onAbort);
+			resolve();
+		}, ms);
+		const onAbort = () => {
+			clearTimeout(id);
+			reject(new DOMException("Aborted", "AbortError"));
+		};
+		signal?.addEventListener("abort", onAbort, { once: true });
+	});
+}
 // src/core/utils/read-field.ts
 /**
 * Case-insensitive field reads for wire payloads.
@@ -312,95 +416,6 @@ function trimTrailing(value, char) {
 	while (end > 0 && value[end - 1] === char) end--;
 	return value.slice(0, end);
 }
-// src/core/utils/warnings.ts
-const warned = /* @__PURE__ */ new Set();
-/** Log `message` the first time `key` is seen: what it reports doesn't change per call. */
-function warnOnce(key, message) {
-	if (warned.has(key)) return;
-	warned.add(key);
-	getLogger().warn(message);
-}
-/**
-* True only in a real browser, where an API key in the config is exposed to users. jsdom defines
-* `window` too, so Node is ruled out by `process.versions.node`, and by jsdom's user-agent marker
-* for setups that hide `process`.
-*/
-function isRealBrowser() {
-	if (typeof window === "undefined") return false;
-	if (globalThis.process?.versions?.node != null) return false;
-	const nav = globalThis.navigator;
-	const userAgent = typeof nav?.userAgent === "string" ? nav.userAgent : "";
-	if (/jsdom/i.test(userAgent)) return false;
-	return true;
-}
-function warnIfClientSide(functionName, suppress) {
-	if (suppress || !isRealBrowser()) return;
-	warnOnce(`client-side:${functionName}`, `Warning: ${functionName} is running on the client side. For better performance and security, consider running this on the server side.`);
-}
-// src/core/compute-fetch/request.ts
-/** `serverUrl` as `validateServerUrl` returns it: no trailing slash. */
-function buildUrl(endpoint, serverUrl) {
-	return `${serverUrl}/${endpoint.replace(/^\/+/, "")}`;
-}
-function isLocalhost(serverUrl) {
-	const hostname = new URL(serverUrl).hostname.toLowerCase();
-	return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "[::1]";
-}
-const DEFAULT_API_KEY_HEADER = "RhinoComputeKey";
-/**
-* Caller headers plus credentials. Every request to the server builds its headers here,
-* so a liveness probe authenticates exactly like the solve it gates.
-*/
-function buildAuthHeaders(auth) {
-	return assertSendable(mergeUnder(auth.headers, credentialHeaders(auth)));
-}
-function buildHeaders(requestId, config) {
-	const headers = assertSendable(mergeUnder(config.headers, {
-		...credentialHeaders(config),
-		"X-Request-ID": requestId,
-		"Content-Type": "application/json"
-	}));
-	if (!config.apiKey && !config.authToken && !isLocalhost(config.serverUrl)) warnOnce(`no-auth:${config.serverUrl}`, `[Compute] Request [${requestId}] targets remote server (${config.serverUrl}) but no API key or auth token is configured. Requests may fail or be rate-limited. (warned once per server)`);
-	return headers;
-}
-/** `headers` with a JSON `Content-Type` that replaces one of any casing already there. */
-function withJsonContentType(headers) {
-	return mergeUnder(headers, { "Content-Type": "application/json" });
-}
-function credentialHeaders(auth) {
-	return {
-		...auth.authToken && { Authorization: auth.authToken },
-		...auth.apiKey && { [auth.apiKeyHeader ?? DEFAULT_API_KEY_HEADER]: auth.apiKey }
-	};
-}
-/**
-* Header names are case-insensitive and fetch joins duplicates, so a caller key
-* matching a transport key in any case is dropped rather than sent alongside it.
-*/
-function mergeUnder(caller, transport) {
-	const taken = new Set(Object.keys(transport).map((name) => name.toLowerCase()));
-	const kept = Object.entries(caller ?? {}).filter(([name]) => !taken.has(name.toLowerCase()));
-	return {
-		...Object.fromEntries(kept),
-		...transport
-	};
-}
-/**
-* Left to fetch, a bad value becomes a retried TypeError that quotes it, and the value may be the
-* API key. `Headers` throws the same message, so its error is not kept as the cause.
-*/
-function assertSendable(headers) {
-	const check = new Headers();
-	for (const [name, value] of Object.entries(headers)) try {
-		check.set(name, value);
-	} catch {
-		throw new ComputeError(`Header "${name}" has an invalid name or value`, ErrorCodes.INVALID_CONFIG, { context: { header: name } });
-	}
-	return headers;
-}
-function generateRequestId() {
-	return `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
-}
 // src/core/utils/encoding.ts
 function getNodeBuffer() {
 	const buf = globalThis.Buffer;
@@ -538,12 +553,20 @@ async function readBodyText(response, limit = Infinity) {
 		truncated: false
 	};
 }
+// src/core/types.ts
+/** Routing outcomes the VektorNode fork reports in `Server-Timing`; the parser drops any other. */
+const AFFINITY_OUTCOMES = [
+	"hit",
+	"claimed",
+	"spilled",
+	"none"
+];
 // src/core/compute-fetch/server-timing.ts
 /**
 * Parse a W3C Server Timing header, as the solve endpoint emits it:
 * `decode;dur=3, solve;dur=120, gh;dur=110, encode;dur=8, recomputed;desc="4/97"`, or
-* `cache;desc="hit"` when the server answered from its result cache. Null when it carries no
-* recognised metric.
+* `cache;desc="hit"` when the server answered from its result cache. A proxy's `affinity` can
+* arrive alone, with no durations. Null when it carries no recognised entry.
 */
 function parseServerTiming(headerValue) {
 	if (!headerValue) return null;
@@ -568,10 +591,18 @@ function parseServerTiming(headerValue) {
 		} else if (name === "cache" && param(params, "desc") === "hit") {
 			timing.cacheHit = true;
 			sawMetric = true;
+		} else if (name === "affinity") {
+			const outcome = param(params, "desc");
+			if (!isAffinity(outcome)) continue;
+			timing.affinity = outcome;
+			sawMetric = true;
 		}
 	}
 	return sawMetric ? timing : null;
 }
+function isAffinity(value) {
+	return AFFINITY_OUTCOMES.includes(value);
+}
 function param(params, key) {
 	for (const p of params) {
 		const [k, ...v] = p.split("=");
@@ -1374,6 +1405,6 @@ function saveFile(blob, filename) {
 	a.remove();
 	setTimeout(() => URL.revokeObjectURL(url), 1e4);
 }
-export { readField as A, withJsonContentType as C, tryParseJson as D, validateServerUrl as E, ErrorCodes as F, abortedByCaller as I, sleep as L, getLogger as M, setLogger as N, redactUrl as O, ComputeError as P, buildAuthHeaders as S, DEFAULT_BLOCKED_HOST as T, readBodyText as _, groupFilesByRoot as a, detectBase64Payload as b, isDefinitionUrl as c, classifyProbeFailure as d, isRedirect as f, raceSignal as g, composeSignal as h, isBase64Flag as i, enableDebugLogging as j, hasField as k, fetchCompute as l, setResponseWireSize as m, downloadFileDataByRoot as n, subFolderSegments as o, getResponseWireSize as p, extractFilesFromComputeResponse as r, isDefinitionRef as s, downloadFileData as t, validateNumbers as u, base64ByteArray as v, warnIfClientSide as w, encodeStringToBase64 as x, decodeBase64ToBinary as y };
+export { buildAuthHeaders as A, validateServerUrl as C, readField as D, hasField as E, getLogger as F, setLogger as I, ComputeError as L, withJsonContentType as M, warnIfClientSide as N, sleep as O, enableDebugLogging as P, ErrorCodes as R, DEFAULT_BLOCKED_HOST as S, redactUrl as T, readBodyText as _, groupFilesByRoot as a, detectBase64Payload as b, isDefinitionUrl as c, classifyProbeFailure as d, isRedirect as f, raceSignal as g, composeSignal as h, isBase64Flag as i, mergeUnder as j, assertSessionId as k, fetchCompute as l, setResponseWireSize as m, downloadFileDataByRoot as n, subFolderSegments as o, getResponseWireSize as p, extractFilesFromComputeResponse as r, isDefinitionRef as s, downloadFileData as t, validateNumbers as u, base64ByteArray as v, tryParseJson as w, encodeStringToBase64 as x, decodeBase64ToBinary as y, abortedByCaller as z };
 
-//# sourceMappingURL=handle-files-D-4X4Uh_.js.map
+//# sourceMappingURL=handle-files-CzqBN3MP.js.map