@camera.ui/transport 0.0.24 → 0.0.26

package/dist/effects/backgroundProbe.d.ts

@@ -2,7 +2,7 @@ import { Kernel } from '../core/kernel.js';
 import { ConnectionTarget, Endpoint, Tokens } from '../core/types.js';
 import { TimeoutByModeFn } from '../race.js';
 import { ProbeContext } from './probeLoop.js';
-export type BackgroundProbeOutcome = 'swap' | 'same' | 'failed' | 'skipped';
+export type BackgroundProbeOutcome = 'swap' | 'same' | 'kept' | 'failed' | 'skipped';
 export interface BackgroundProbeOptions {
     readonly kernel: Kernel;
     readonly discover: (signal: AbortSignal) => Promise<readonly Endpoint[]>;
@@ -11,6 +11,7 @@ export interface BackgroundProbeOptions {
     readonly timeoutByMode?: TimeoutByModeFn;
     readonly prefer?: (endpoint: Endpoint) => boolean;
     readonly preferGraceMs?: number;
+    readonly isCurrentHealthy?: () => boolean;
     readonly onResult?: (outcome: BackgroundProbeOutcome, detail?: string) => void;
 }
 export interface BackgroundProbe {

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"));
 				}
 			});
@@ -330,7 +331,12 @@ function createBackgroundProbe(options) {
 				options.onResult?.("skipped", `phase=${phase.kind}`);
 				return "skipped";
 			}
-			const same = phase.target.endpoint.url === endpoint.url && phase.target.endpoint.mode === endpoint.mode;
+			const current = phase.target.endpoint;
+			const same = current.url === endpoint.url && current.mode === endpoint.mode;
+			if (!same && options.prefer && options.prefer(current) && !options.prefer(endpoint) && options.isCurrentHealthy?.() === true) {
+				options.onResult?.("kept", current.url);
+				return "kept";
+			}
 			options.kernel.dispatch({
 				type: "ENDPOINT_SWAP",
 				endpoint,
@@ -778,9 +784,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 +798,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/dist/transports/nats.js

@@ -103,9 +103,7 @@ function createNatsTransport(options = {}) {
 						markDown("staleConnection");
 						notifyClient();
 						break;
-					case "error":
-						handleErrorEvent(event);
-						break;
+					case "error": handleErrorEvent(event);
 				}
 			}
 		})().catch(() => {});
@@ -144,8 +142,9 @@ function createNatsTransport(options = {}) {
 			notifyClient();
 		}
 		connId = newConnId();
+		const servers = buildServers(target);
 		const next = createRPCClient({
-			servers: buildServers(target),
+			servers,
 			name: clientName,
 			connId,
 			auth: {

package/dist/transports/socketio.js

@@ -87,7 +87,8 @@ function createSocketioTransport(options = {}) {
 		return `${new URL(target.endpoint.url).pathname.replace(/\/$/, "")}${path}`;
 	}
 	function openSocket(namespace, target) {
-		const sock = io(`${socketOrigin(target)}${namespace}`, {
+		const url = `${socketOrigin(target)}${namespace}`;
+		const sock = io(url, {
 			path: socketPath(target),
 			auth: buildAuth(target),
 			query: buildQuery(target),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camera.ui/transport",
-  "version": "0.0.24",
+  "version": "0.0.26",
   "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",
@@ -56,25 +56,25 @@
   },
   "dependencies": {
     "@camera.ui/logger": ">=0.0.3",
-    "@camera.ui/rpc": ">=1.0.10",
-    "axios": ">=1.18.1",
+    "@camera.ui/rpc": ">=1.0.11",
+    "axios": ">=1.19.0",
     "socket.io-client": ">=4.8.3"
   },
   "devDependencies": {
     "@eslint/js": "9.39.4",
     "@stylistic/eslint-plugin": "^5.10.0",
-    "@typescript-eslint/parser": "^8.65.0",
-    "@vue/language-core": "^3.3.8",
+    "@typescript-eslint/parser": "^8.67.0",
+    "@vue/language-core": "^3.3.10",
     "eslint": "9.39.2",
-    "globals": "^17.7.0",
+    "globals": "^17.11.0",
     "jiti": "^2.7.0",
     "prettier": "^3.9.6",
     "rimraf": "^6.1.3",
     "typescript": "5.9.3",
-    "typescript-eslint": "^8.65.0",
+    "typescript-eslint": "^8.67.0",
     "unplugin-dts": "^1.0.3",
-    "updates": "^17.19.1",
-    "vite": "^8.1.5",
+    "updates": "^18.0.1",
+    "vite": "^8.2.1",
     "vitest": "^4.1.10"
   },
   "overrides": {