@selvajs/compute 5.0.0 → 5.1.0-beta.0

package/dist/core.d.ts

@@ -1,4 +1,4 @@
-import { a as DefinitionRef, c as ComputeAuth, d as ServerErrorCodeMap, f as ServerTiming, h as ErrorCodes, i as ProcessedFile, l as ComputeConfig, m as ErrorCode, n as FileBaseInfo, o as SolveDefinition, p as ComputeError, r as FileData, s as isDefinitionRef, t as DownloadOptions, u as RetryPolicy } from "./types-Dm9QFVvA.js";
+import { a as DefinitionRef, c as ComputeAuth, d as ServerErrorCodeMap, f as ServerTiming, h as ErrorCodes, i as ProcessedFile, l as ComputeConfig, m as ErrorCode, n as FileBaseInfo, o as SolveDefinition, p as ComputeError, r as FileData, s as isDefinitionRef, t as DownloadOptions, u as RetryPolicy } from "./types-CcKxH26w.js";
 /**
  * POST `args` as JSON to `<serverUrl>/<endpoint>` with retry, timeout and abort handling, and
  * return the parsed response. Most callers want a higher-level API.

package/dist/core.js

@@ -1 +1 @@
-export { P as ComputeError, T as DEFAULT_BLOCKED_HOST, F as ErrorCodes, d as classifyProbeFailure, y as decodeBase64ToBinary, t as downloadFileData, n as downloadFileDataByRoot, j as enableDebugLogging, r as extractFilesFromComputeResponse, l as fetchCompute, M as getLogger, a as groupFilesByRoot, k as hasField, s as isDefinitionRef, A as readField, N as setLogger, o as subFolderSegments, E as validateServerUrl } from "./handle-files-D-4X4Uh_.js";
+export { L as ComputeError, S as DEFAULT_BLOCKED_HOST, R as ErrorCodes, d as classifyProbeFailure, y as decodeBase64ToBinary, t as downloadFileData, n as downloadFileDataByRoot, P as enableDebugLogging, r as extractFilesFromComputeResponse, l as fetchCompute, F as getLogger, a as groupFilesByRoot, E as hasField, s as isDefinitionRef, D as readField, I as setLogger, o as subFolderSegments, C as validateServerUrl } from "./handle-files-CzqBN3MP.js";

package/dist/grasshopper.d.ts

@@ -1,4 +1,4 @@
-import { c as ComputeAuth, f as ServerTiming, l as ComputeConfig, n as FileBaseInfo, o as SolveDefinition, p as ComputeError, u as RetryPolicy } from "./types-Dm9QFVvA.js";
+import { c as ComputeAuth, f as ServerTiming, l as ComputeConfig, n as FileBaseInfo, o as SolveDefinition, p as ComputeError, u as RetryPolicy } from "./types-CcKxH26w.js";
 interface ServerVersion {
   rhino: string;
   compute: string;
@@ -12,6 +12,12 @@ interface ServerLimits {
   maxRequestBytes: number;
   /** A stale definition pointer answers `definition_not_cached`, so pointer reuse is safe. */
   signalsStaleDefinition: boolean;
+  /**
+   * Changes whenever the server's plugins may have: it restarted (how a plugin is redeployed) or
+   * recycled its children. A solve result from another deployment may be wrong. `null` when the
+   * server doesn't report one.
+   */
+  deploymentId: string | null;
 }
 interface ServerStats {
   isOnline: boolean;
@@ -736,6 +742,16 @@ interface SchedulerSolveOptions {
   signal?: AbortSignal;
   /** Per-solve live-event callback. Not part of the cache key: it names where events go, not what is solved. */
   selvaevents?: SelvaEventTarget;
+  /**
+   * Routes this solve to its session's warm child; see `ComputeConfig.sessionId`. Not part of the
+   * cache key, so sessions still share cached results.
+   */
+  sessionId?: string;
+  /**
+   * Request headers for this solve only. One replaces a client config header of any casing; the
+   * transport's own still win. Not part of the cache key.
+   */
+  headers?: Record<string, string>;
   /**
    * This call's `Server-Timing` breakdown, after the client config's own `onServerTiming`.
    * Never fires for a `fromCache` hit, which sends no request.
@@ -918,6 +934,13 @@ interface SolveOptions {
   retry?: RetryPolicy;
   /** Per-solve live-event callback, forwarded onto the request body. */
   selvaevents?: SelvaEventTarget;
+  /** Routes this solve to its session's warm child; see {@link ComputeConfig.sessionId}. */
+  sessionId?: string;
+  /**
+   * Request headers for this solve only. One replaces a client config header of any casing; the
+   * transport's own still win.
+   */
+  headers?: Record<string, string>;
 }
 /** Options for {@link GrasshopperClient.create} that shape construction, not the solves. */
 interface CreateClientOptions {

package/dist/grasshopper.js

@@ -1,4 +1,4 @@
-import { A as readField, C as withJsonContentType, D as tryParseJson, E as validateServerUrl, F as ErrorCodes, I as abortedByCaller, L as sleep, M as getLogger, O as redactUrl, P as ComputeError, S as buildAuthHeaders, _ as readBodyText, b as detectBase64Payload, c as isDefinitionUrl, d as classifyProbeFailure, f as isRedirect, g as raceSignal, h as composeSignal, i as isBase64Flag, k as hasField, l as fetchCompute, m as setResponseWireSize, p as getResponseWireSize, s as isDefinitionRef, t as downloadFileData, u as validateNumbers, v as base64ByteArray, w as warnIfClientSide, x as encodeStringToBase64 } from "./handle-files-D-4X4Uh_.js";
+import { A as buildAuthHeaders, C as validateServerUrl, D as readField, E as hasField, F as getLogger, L as ComputeError, M as withJsonContentType, N as warnIfClientSide, O as sleep, R as ErrorCodes, T as redactUrl, _ as readBodyText, b as detectBase64Payload, c as isDefinitionUrl, d as classifyProbeFailure, f as isRedirect, g as raceSignal, h as composeSignal, i as isBase64Flag, j as mergeUnder, k as assertSessionId, l as fetchCompute, m as setResponseWireSize, p as getResponseWireSize, s as isDefinitionRef, t as downloadFileData, u as validateNumbers, v as base64ByteArray, w as tryParseJson, x as encodeStringToBase64, z as abortedByCaller } from "./handle-files-CzqBN3MP.js";
 // src/grasshopper/server/compute-server-stats.ts
 /**
 * Server health and control: liveness, version, child processes, cache purges.
@@ -186,7 +186,8 @@ var ComputeServerStats = class ComputeServerStats {
 		return {
 			timeoutSeconds: json.timeoutSeconds,
 			maxRequestBytes: json.maxRequestBytes,
-			signalsStaleDefinition: json.signalsStaleDefinition === true
+			signalsStaleDefinition: json.signalsStaleDefinition === true,
+			deploymentId: typeof json.deploymentId === "string" && json.deploymentId !== "" ? json.deploymentId : null
 		};
 	}
 	/**
@@ -1801,6 +1802,7 @@ var SolveScheduler = class {
 	lastStateSeq = 0;
 	disposed = false;
 	constructor(executor, baseConfig, options = {}) {
+		assertSessionId(baseConfig.sessionId);
 		this.executor = executor;
 		this.baseConfig = baseConfig;
 		this.mode = options.mode ?? "latest-wins";
@@ -1896,6 +1898,11 @@ var SolveScheduler = class {
 	/** {@link solve}, also resolving with whether this call hit the cache and how long it took. */
 	solveDetailed(definition, dataTree, options) {
 		if (this.disposed) return Promise.reject(new ComputeError("SolveScheduler has been disposed and cannot be used", ErrorCodes.INVALID_STATE));
+		try {
+			assertSessionId(options?.sessionId);
+		} catch (error) {
+			return Promise.reject(error);
+		}
 		const hashes = new SolveInputHashes(() => this.hashDefinitionMemo(definition), dataTree);
 		let key = "";
 		if (this.cache.enabled || this.onStart || this.onSettle || this.onSuperseded) try {
@@ -1943,6 +1950,8 @@ var SolveScheduler = class {
 				reject,
 				externalSignal: options?.signal,
 				selvaevents: options?.selvaevents,
+				sessionId: options?.sessionId,
+				headers: options?.headers,
 				onServerTiming: options?.onServerTiming
 			};
 			if (item.externalSignal) {
@@ -2052,7 +2061,9 @@ var SolveScheduler = class {
 				signal: controller.signal,
 				...this.timeoutMs !== void 0 && { timeoutMs: this.timeoutMs },
 				...this.retry !== void 0 && { retry: this.retry },
-				...item.selvaevents !== void 0 && { selvaevents: item.selvaevents }
+				...item.selvaevents !== void 0 && { selvaevents: item.selvaevents },
+				...item.sessionId !== void 0 && { sessionId: item.sessionId },
+				...item.headers !== void 0 && { headers: mergeUnder(this.baseConfig.headers, item.headers) }
 			};
 			const callTiming = item.onServerTiming;
 			if (callTiming) {
@@ -2301,6 +2312,7 @@ var GrasshopperClient = class GrasshopperClient {
 	*/
 	static CREATE_PROBE_TIMEOUT_MS = 2e3;
 	constructor(config) {
+		assertSessionId(config.sessionId);
 		this.config = {
 			...config,
 			serverUrl: validateServerUrl(config.serverUrl),
@@ -2394,12 +2406,15 @@ var GrasshopperClient = class GrasshopperClient {
 			if (typeof definition === "string" && !definition.trim()) throw new ComputeError("Definition URL/content is required", ErrorCodes.INVALID_INPUT, { context: { receivedUrl: definition } });
 			else if (definition instanceof Uint8Array && definition.length === 0) throw new ComputeError("Definition content is empty", ErrorCodes.INVALID_INPUT);
 			else if (isDefinitionRef(definition) && !definition.key.trim()) throw new ComputeError("DefinitionRef key is empty", ErrorCodes.INVALID_INPUT);
+			assertSessionId(options?.sessionId);
 			const result = await solveGrasshopperDefinition(dataTree, definition, {
 				...this.config,
 				...options?.signal !== void 0 && { signal: options.signal },
 				...options?.timeoutMs !== void 0 && { timeoutMs: options.timeoutMs },
 				...options?.retry !== void 0 && { retry: options.retry },
-				...options?.selvaevents !== void 0 && { selvaevents: options.selvaevents }
+				...options?.selvaevents !== void 0 && { selvaevents: options.selvaevents },
+				...options?.sessionId !== void 0 && { sessionId: options.sessionId },
+				...options?.headers !== void 0 && { headers: mergeUnder(this.config.headers, options.headers) }
 			});
 			const solveErrors = readField(result, "errors");
 			if (Array.isArray(solveErrors) && solveErrors.length > 0) throw new ComputeError(solveErrors.map(String).join("; ") || "Computation failed", ErrorCodes.COMPUTATION_ERROR, { context: {