@camera.ui/transport 0.0.5 → 0.0.6

package/README.md

@@ -7,4 +7,4 @@ The camera.ui transport layer — a framework-agnostic connection kernel with pl
 
 ---
 
-*Part of the camera.ui ecosystem - A comprehensive camera management solution.*
+_Part of the camera.ui ecosystem - A comprehensive camera management solution._

package/dist/effects/reconnectWatchdog.d.ts

@@ -0,0 +1,10 @@
+import { Kernel } from '../core/kernel.js';
+export type Detach = () => void;
+export interface ReconnectWatchdogOptions {
+    readonly kernel: Kernel;
+    readonly escalateAfterMs?: number;
+    readonly setTimer?: (cb: () => void, ms: number) => unknown;
+    readonly clearTimer?: (handle: unknown) => void;
+    readonly onEscalate?: (attempt: number) => void;
+}
+export declare function attachReconnectWatchdog(options: ReconnectWatchdogOptions): Detach;

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export { attachNetworkChange } from './effects/networkChange.js';
 export { attachPersistence, localStorageAdapter, memoryStorageAdapter } from './effects/persistence.js';
 export { attachPresence, defaultOnNetworkOnline } from './effects/presence.js';
 export { attachProbeLoop, isProbeFailure, makeProbeFailure } from './effects/probeLoop.js';
+export { attachReconnectWatchdog } from './effects/reconnectWatchdog.js';
 export { attachTokenLifecycle } from './effects/tokenLifecycle.js';
 export { attachTransportSync } from './effects/transportSync.js';
 export { attachTransportWatchdog } from './effects/transportWatchdog.js';
@@ -21,6 +22,7 @@ export type { NetworkChangeOptions, NetworkChangeSource } from './effects/networ
 export type { PersistedTarget, Persistence, PersistenceOptions, StorageAdapter } from './effects/persistence.js';
 export type { PresenceCallback, PresenceOptions, VisibilitySource } from './effects/presence.js';
 export type { ProbeContext, ProbeFailure, ProbeFailureKind, ProbeLoopOptions } from './effects/probeLoop.js';
+export type { ReconnectWatchdogOptions } from './effects/reconnectWatchdog.js';
 export type { Detach, RefreshReason, TokenLifecycle, TokenLifecycleOptions } from './effects/tokenLifecycle.js';
 export type { TransportSyncOptions } from './effects/transportSync.js';
 export type { TransportWatchdogOptions, WatchdogClearReason } from './effects/transportWatchdog.js';

package/dist/index.js

@@ -717,6 +717,45 @@ function attachProbeLoop(options) {
 	};
 }
 //#endregion
+//#region src/effects/reconnectWatchdog.ts
+var DEFAULT_ESCALATE_AFTER_MS = 12e3;
+function attachReconnectWatchdog(options) {
+	const escalateAfterMs = options.escalateAfterMs ?? DEFAULT_ESCALATE_AFTER_MS;
+	const setTimer = options.setTimer ?? ((cb, ms) => setTimeout(cb, ms));
+	const clearTimer = options.clearTimer ?? ((h) => clearTimeout(h));
+	let timer;
+	let attempt = 0;
+	let detached = false;
+	function cancelTimer() {
+		if (timer !== void 0) {
+			clearTimer(timer);
+			timer = void 0;
+		}
+	}
+	function arm() {
+		cancelTimer();
+		timer = setTimer(() => {
+			timer = void 0;
+			if (detached) return;
+			if (options.kernel.phase.kind !== "reconnecting") return;
+			attempt += 1;
+			options.onEscalate?.(attempt);
+			options.kernel.dispatch({ type: "USER_RETRY" });
+		}, escalateAfterMs);
+	}
+	const unsubKernel = options.kernel.subscribe((next, prev) => {
+		if (next.kind === "reconnecting" && prev.kind !== "reconnecting") arm();
+		else if (next.kind !== "reconnecting" && prev.kind === "reconnecting") cancelTimer();
+		if (next.kind === "online" || next.kind === "idle") attempt = 0;
+	});
+	if (options.kernel.phase.kind === "reconnecting") arm();
+	return () => {
+		detached = true;
+		cancelTimer();
+		unsubKernel();
+	};
+}
+//#endregion
 //#region src/effects/tokenLifecycle.ts
 var DEFAULT_GRACE_MS$1 = 5e3;
 var DEFAULT_MAX_TRANSIENT_RETRIES = 3;
@@ -1098,4 +1137,4 @@ function attachWorkerBridge(options) {
 	};
 }
 //#endregion
-export { DEFAULT_RACE_TIMEOUT_BY_MODE, RaceFirstError, TransportEmitter, attachBackoff, attachCrossTab, attachNetworkChange, attachPersistence, attachPresence, attachProbeLoop, attachTokenLifecycle, attachTransportSync, attachTransportWatchdog, attachWorkerBridge, createKernel, defaultOnNetworkOnline, endpointKey, isEndpointChange, isProbeFailure, isSameEndpoint, isSameTarget, isTokenOnlyChange, localStorageAdapter, makeProbeFailure, memoryStorageAdapter, raceFirst, reducer, sortByPriority };
+export { DEFAULT_RACE_TIMEOUT_BY_MODE, RaceFirstError, TransportEmitter, attachBackoff, attachCrossTab, attachNetworkChange, attachPersistence, attachPresence, attachProbeLoop, attachReconnectWatchdog, attachTokenLifecycle, attachTransportSync, attachTransportWatchdog, attachWorkerBridge, createKernel, defaultOnNetworkOnline, endpointKey, isEndpointChange, isProbeFailure, isSameEndpoint, isSameTarget, isTokenOnlyChange, localStorageAdapter, makeProbeFailure, memoryStorageAdapter, raceFirst, reducer, sortByPriority };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camera.ui/transport",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "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",
@@ -57,21 +57,21 @@
   },
   "dependencies": {
     "@camera.ui/rpc": ">=1.0.4",
-    "axios": ">=1.18.0",
+    "axios": ">=1.18.1",
     "socket.io-client": ">=4.8.3"
   },
   "devDependencies": {
     "@eslint/js": "9.39.4",
     "@stylistic/eslint-plugin": "^5.10.0",
-    "@typescript-eslint/parser": "^8.61.1",
+    "@typescript-eslint/parser": "^8.62.0",
     "@vue/language-core": "^3.3.5",
     "eslint": "9.39.2",
-    "globals": "^17.6.0",
+    "globals": "^17.7.0",
     "jiti": "^2.7.0",
     "prettier": "^3.8.4",
     "rimraf": "^6.1.3",
     "typescript": "5.9.3",
-    "typescript-eslint": "^8.61.1",
+    "typescript-eslint": "^8.62.0",
     "unplugin-dts": "^1.0.2",
     "updates": "^17.18.0",
     "vite": "^8.0.16",