@camera.ui/transport 0.0.22 → 0.0.23

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/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);
 	};
 }

package/package.json

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