@camera.ui/transport 0.0.24 → 0.0.25

package/dist/index.js

@@ -192,7 +192,7 @@ var RaceFirstError = class extends Error {
 	}
 };
 function raceFirst(candidates, options = {}) {
-	const { timeoutByMode = (mode) => DEFAULT_RACE_TIMEOUT_BY_MODE[mode] ?? 5e3, shortCircuit, parentSignal, prefer } = options;
+	const { timeoutByMode = (mode) => DEFAULT_RACE_TIMEOUT_BY_MODE[mode] ?? 5e3, shortCircuit, informative, parentSignal, prefer } = options;
 	const preferGraceMs = options.preferGraceMs ?? DEFAULT_PREFER_GRACE_MS;
 	return new Promise((resolve, reject) => {
 		if (candidates.length === 0) {
@@ -215,7 +215,7 @@ function raceFirst(candidates, options = {}) {
 		const timers = [];
 		function cleanupAllExcept(except) {
 			for (const t of timers) clearTimeout(t);
-			for (const a of abortControllers) if (a !== except) a.abort();
+			for (const a of abortControllers) if (a !== except) a.abort("race-settled");
 		}
 		function finishSuccess(endpoint, value, except) {
 			if (settled) return;
@@ -259,7 +259,7 @@ function raceFirst(candidates, options = {}) {
 			const ctrl = new AbortController();
 			abortControllers.push(ctrl);
 			const delay = timeoutByMode(cand.endpoint.mode);
-			const timer = setTimeout(() => ctrl.abort(), delay);
+			const timer = setTimeout(() => ctrl.abort("race-timeout"), delay);
 			timers.push(timer);
 			cand.run(ctrl.signal).then((value) => handleSuccess(cand.endpoint, value, ctrl), (err) => {
 				if (settled) {
@@ -282,10 +282,11 @@ function raceFirst(candidates, options = {}) {
 				}
 				remaining--;
 				if (remaining <= 0) {
-					const [endpoint, cause] = [...lastErrors.entries()].find(([, e]) => {
+					const usable = [...lastErrors.entries()].filter(([, e]) => {
 						if (e instanceof RaceFirstError) return e.kind !== "all-failed" || !(e.cause instanceof Error && e.cause.message === "aborted");
 						return true;
-					}) ?? [cand.endpoint, finalErr];
+					});
+					const [endpoint, cause] = (informative ? usable.find(([, e]) => informative(e instanceof RaceFirstError ? e.cause : e)) : void 0) ?? usable[0] ?? [cand.endpoint, finalErr];
 					finishFail(new RaceFirstError("raceFirst: all candidates failed", endpoint, cause, "all-failed"));
 				}
 			});
@@ -778,9 +779,9 @@ function attachProbeLoop(options) {
 					options.onProbeSuccess?.(endpoint, tokens);
 					return tokens;
 				} catch (err) {
-					const isLocalTimeout = signal.aborted && !ctrl.signal.aborted && !isProbeFailure(err);
-					const timeout = (options.timeoutByMode ?? ((m) => DEFAULT_RACE_TIMEOUT_BY_MODE[m] ?? 5e3))(endpoint.mode);
-					const finalErr = isLocalTimeout ? makeProbeFailure("transient", `timeout (${timeout}ms)`) : err;
+					let finalErr = err;
+					if (signal.aborted && !ctrl.signal.aborted && !isProbeFailure(err)) if (signal.reason === "race-settled") finalErr = makeProbeFailure("transient", "superseded");
+					else finalErr = makeProbeFailure("transient", `timeout (${(options.timeoutByMode ?? ((m) => DEFAULT_RACE_TIMEOUT_BY_MODE[m] ?? 5e3))(endpoint.mode)}ms)`);
 					options.onProbeError?.(endpoint, finalErr);
 					throw finalErr;
 				}
@@ -792,7 +793,8 @@ function attachProbeLoop(options) {
 				parentSignal: ctrl.signal,
 				prefer: options.prefer,
 				preferGraceMs: options.preferGraceMs,
-				shortCircuit: (err) => isProbeFailure(err) && (err.kind === "needs-auth" || err.kind === "fatal" || err.kind === "aborted")
+				shortCircuit: (err) => isProbeFailure(err) && (err.kind === "needs-auth" || err.kind === "fatal"),
+				informative: (cause) => !(isProbeFailure(cause) && cause.kind === "aborted")
 			});
 			if (ctrl.signal.aborted) return;
 			options.kernel.dispatch({

package/dist/race.d.ts

@@ -6,11 +6,12 @@ export interface RaceCandidate<T> {
     readonly run: (signal: AbortSignal) => Promise<T>;
 }
 export interface RaceFirstOptions {
+    readonly parentSignal?: AbortSignal;
+    readonly preferGraceMs?: number;
     readonly timeoutByMode?: TimeoutByModeFn;
     readonly shortCircuit?: (err: unknown) => boolean;
-    readonly parentSignal?: AbortSignal;
+    readonly informative?: (cause: unknown) => boolean;
     readonly prefer?: (endpoint: Endpoint) => boolean;
-    readonly preferGraceMs?: number;
 }
 export interface RaceFirstResult<T> {
     readonly endpoint: Endpoint;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camera.ui/transport",
-  "version": "0.0.24",
+  "version": "0.0.25",
   "description": "camera.ui transport layer — framework-agnostic connection kernel, reducer state, pluggable transports (HTTP/WS/Socket.IO/NATS), lifecycle effects and worker bridge",
   "author": "seydx (https://github.com/cameraui/clients)",
   "type": "module",
@@ -66,7 +66,7 @@
     "@typescript-eslint/parser": "^8.65.0",
     "@vue/language-core": "^3.3.8",
     "eslint": "9.39.2",
-    "globals": "^17.7.0",
+    "globals": "^17.8.0",
     "jiti": "^2.7.0",
     "prettier": "^3.9.6",
     "rimraf": "^6.1.3",