@camera.ui/transport 0.0.5 → 0.0.7

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/dist/transports/socketio.d.ts

@@ -15,5 +15,6 @@ export interface SocketioTransport extends Transport {
     readonly manager: Manager | null;
     socket(namespace?: string): Socket | null;
     ensureSocket(namespace: string): Socket | null;
+    reviveDeadSockets(): void;
 }
 export declare function createSocketioTransport(options?: SocketioTransportOptions): SocketioTransport;

package/dist/transports/socketio.js

@@ -47,17 +47,46 @@ function createSocketioTransport(options = {}) {
 		};
 		emitter.emit("down", { reason });
 	}
+	function isAuthError(msg) {
+		const m = msg.toLowerCase();
+		return m.includes("auth") || m.includes("unauthorized");
+	}
+	function bindCommonAuthEvents(socket) {
+		let rotatedOut = false;
+		socket.on("unauthenticated", () => {
+			const fresh = currentTarget ? buildAuth(currentTarget) : null;
+			const current = socket.auth?.token;
+			if (fresh && current !== fresh.token) {
+				socket.auth = fresh;
+				rotatedOut = true;
+			} else emitter.emit("auth-error", { message: "unauthenticated" });
+		});
+		socket.on("disconnect", () => {
+			if (rotatedOut) {
+				rotatedOut = false;
+				socket.connect();
+			}
+		});
+	}
 	function bindMainSocketEvents(socket) {
 		socket.on("connect", () => markUp());
 		socket.on("disconnect", (reason) => markDown(reason));
 		socket.on("connect_error", (err) => {
 			const msg = err?.message ?? "connect_error";
-			if (msg.toLowerCase().includes("auth") || msg.toLowerCase().includes("unauthorized")) {
+			if (isAuthError(msg)) {
 				emitter.emit("auth-error", { message: msg });
 				return;
 			}
 			markDown(msg);
 		});
+		bindCommonAuthEvents(socket);
+	}
+	function bindSecondarySocketEvents(socket) {
+		socket.on("connect_error", (err) => {
+			const msg = err?.message ?? "connect_error";
+			if (isAuthError(msg)) emitter.emit("auth-error", { message: msg });
+		});
+		bindCommonAuthEvents(socket);
 	}
 	function openSocket(namespace, target) {
 		const sock = io(`${target.endpoint.url}${namespace}`, {
@@ -101,7 +130,10 @@ function createSocketioTransport(options = {}) {
 	}
 	function rebindAuth(target) {
 		const auth = buildAuth(target);
-		for (const sock of sockets.values()) sock.auth = auth;
+		for (const sock of sockets.values()) {
+			sock.auth = auth;
+			if (!sock.connected) sock.connect();
+		}
 	}
 	async function apply(target) {
 		if (disposed) throw new Error("socketio-transport disposed");
@@ -138,9 +170,20 @@ function createSocketioTransport(options = {}) {
 	function ensureSocket(namespace) {
 		if (!currentTarget) return null;
 		let sock = sockets.get(namespace);
-		if (!sock) sock = openSocket(namespace, currentTarget);
+		if (!sock) {
+			sock = openSocket(namespace, currentTarget);
+			bindSecondarySocketEvents(sock);
+		}
 		return sock;
 	}
+	function reviveDeadSockets() {
+		if (!currentTarget) return;
+		const auth = buildAuth(currentTarget);
+		for (const sock of sockets.values()) if (!sock.connected) {
+			sock.auth = auth;
+			sock.connect();
+		}
+	}
 	return {
 		get spec() {
 			return spec;
@@ -153,7 +196,8 @@ function createSocketioTransport(options = {}) {
 		on,
 		dispose,
 		socket,
-		ensureSocket
+		ensureSocket,
+		reviveDeadSockets
 	};
 }
 //#endregion

package/package.json

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