@camera.ui/transport 0.0.22 → 0.0.24

package/dist/effects/degradedRecovery.d.ts

@@ -8,7 +8,9 @@ export interface DegradedRecoveryOptions {
     readonly ensureAll: () => void;
     readonly probe: () => Promise<BackgroundProbeOutcome>;
     readonly graceMs?: number;
+    readonly isReachable?: () => boolean;
     readonly onEscalate?: (round: number) => void;
     readonly onOffline?: (reason: string) => void;
+    readonly onHold?: (reason: string) => void;
 }
 export declare function attachDegradedRecovery(options: DegradedRecoveryOptions): Detach;

package/dist/effects/networkChange.d.ts

@@ -6,5 +6,6 @@ export interface NetworkChangeOptions {
     readonly kernel: Kernel;
     readonly source: NetworkChangeSource;
     readonly onChange: (kernel: Kernel, event: Event) => void;
+    readonly debounceMs?: number;
 }
 export declare function attachNetworkChange(options: NetworkChangeOptions): Detach;

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

@@ -495,6 +495,11 @@ function attachDegradedRecovery(options) {
 		const outcome = await options.probe();
 		if (detached || options.signal.current.kind !== "degraded") return;
 		if (outcome === "failed") {
+			if (options.isReachable?.()) {
+				options.onHold?.("probe failed but a channel is up — holding");
+				arm();
+				return;
+			}
 			options.onOffline?.("degraded: endpoint unreachable");
 			options.kernel.dispatch({
 				type: "PROBE_FAILED_ALL",
@@ -518,14 +523,28 @@ function attachDegradedRecovery(options) {
 //#endregion
 //#region src/effects/networkChange.ts
 function attachNetworkChange(options) {
+	const debounceMs = options.debounceMs ?? 0;
 	let detached = false;
+	let timer = null;
 	const handler = (event) => {
 		if (detached) return;
-		options.onChange(options.kernel, event);
+		if (debounceMs <= 0) {
+			options.onChange(options.kernel, event);
+			return;
+		}
+		if (timer !== null) clearTimeout(timer);
+		timer = setTimeout(() => {
+			timer = null;
+			if (!detached) options.onChange(options.kernel, event);
+		}, debounceMs);
 	};
 	options.source.addEventListener("change", handler);
 	return () => {
 		detached = true;
+		if (timer !== null) {
+			clearTimeout(timer);
+			timer = null;
+		}
 		options.source.removeEventListener("change", handler);
 	};
 }
@@ -817,9 +836,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));
@@ -907,11 +928,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
 				});
@@ -924,6 +948,7 @@ function attachTokenLifecycle(options) {
 				transientRetries = 0;
 				options.onRefreshError?.(reason, err, {
 					transient,
+					serverError,
 					retriesLeft: 0,
 					willRetry: false
 				});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camera.ui/transport",
-  "version": "0.0.22",
+  "version": "0.0.24",
   "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",