@camera.ui/transport 0.0.23 → 0.0.25

package/dist/effects/tokenLifecycle.d.ts

@@ -5,11 +5,13 @@ export type RefreshReason = 'proactive' | 'auth-error';
 export interface TokenLifecycleOptions {
     readonly kernel: Kernel;
     readonly transports: readonly Transport[];
-    readonly refresh: (target: ConnectionTarget, reason: RefreshReason) => Promise<Tokens>;
     readonly graceMs?: number;
-    readonly isTransientError?: (err: unknown) => boolean;
     readonly maxTransientRetries?: number;
     readonly transientRetryDelayMs?: number;
+    readonly maxServerErrorRetries?: number;
+    readonly refresh: (target: ConnectionTarget, reason: RefreshReason) => Promise<Tokens>;
+    readonly isTransientError?: (err: unknown) => boolean;
+    readonly isServerError?: (err: unknown) => boolean;
     readonly now?: () => number;
     readonly setTimer?: (cb: () => void, ms: number) => unknown;
     readonly clearTimer?: (handle: unknown) => void;
@@ -20,6 +22,7 @@ export interface TokenLifecycleOptions {
     readonly onRefreshSkipped?: (reason: RefreshReason, tokens: Tokens) => void;
     readonly onRefreshError?: (reason: RefreshReason, error: unknown, info: {
         transient: boolean;
+        serverError: boolean;
         retriesLeft: number;
         willRetry: boolean;
     }) => void;

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({
@@ -836,9 +838,11 @@ var DEFAULT_TRANSIENT_RETRY_DELAY_MS = 2e3;
 var MAX_TIMER_DELAY_MS = 2 ** 31 - 1;
 function attachTokenLifecycle(options) {
 	const graceMs = options.graceMs ?? DEFAULT_GRACE_MS;
-	const isTransient = options.isTransientError ?? (() => false);
 	const maxTransientRetries = options.maxTransientRetries ?? DEFAULT_MAX_TRANSIENT_RETRIES;
+	const maxServerErrorRetries = options.maxServerErrorRetries ?? maxTransientRetries;
 	const transientRetryDelayMs = options.transientRetryDelayMs ?? DEFAULT_TRANSIENT_RETRY_DELAY_MS;
+	const isTransient = options.isTransientError ?? (() => false);
+	const isServerError = options.isServerError ?? (() => false);
 	const now = options.now ?? (() => Date.now());
 	const setTimer = options.setTimer ?? ((cb, ms) => setTimeout(cb, ms));
 	const clearTimer = options.clearTimer ?? ((h) => clearTimeout(h));
@@ -926,11 +930,14 @@ function attachTokenLifecycle(options) {
 		} catch (err) {
 			if (detached) return;
 			const transient = isTransient(err);
-			if (transient && transientRetries < maxTransientRetries) {
+			const serverError = transient && isServerError(err);
+			const budget = serverError ? maxServerErrorRetries : maxTransientRetries;
+			if (transient && transientRetries < budget) {
 				transientRetries++;
-				const retriesLeft = maxTransientRetries - transientRetries;
+				const retriesLeft = budget - transientRetries;
 				options.onRefreshError?.(reason, err, {
 					transient: true,
+					serverError,
 					retriesLeft,
 					willRetry: true
 				});
@@ -943,6 +950,7 @@ function attachTokenLifecycle(options) {
 				transientRetries = 0;
 				options.onRefreshError?.(reason, err, {
 					transient,
+					serverError,
 					retriesLeft: 0,
 					willRetry: false
 				});

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.23",
+  "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",