@camera.ui/transport 0.0.16 → 0.0.18

package/dist/transports/http.d.ts

@@ -1,3 +1,4 @@
+import { Logger } from '@camera.ui/logger';
 import { AxiosInstance, AxiosRequestConfig } from 'axios';
 import { TransportSpec } from '../core/types.js';
 import { Transport } from './contract.js';
@@ -6,6 +7,7 @@ export interface HttpTransportOptions {
     readonly timeoutMs?: number;
     readonly targetWaitMs?: number;
     readonly spec?: Partial<TransportSpec>;
+    readonly logger?: Logger;
 }
 export interface HttpTransport extends Transport {
     readonly client: AxiosInstance;

package/dist/transports/http.js

@@ -13,6 +13,7 @@ function createHttpTransport(options = {}) {
 	};
 	const apiPrefix = options.apiPrefix ?? "/api";
 	const targetWaitMs = options.targetWaitMs ?? 15e3;
+	const logger = options.logger;
 	const emitter = new TransportEmitter();
 	let currentTarget = null;
 	let status = { up: false };
@@ -63,6 +64,7 @@ function createHttpTransport(options = {}) {
 	client.interceptors.response.use((response) => {
 		if (!status.up) {
 			status = { up: true };
+			logger?.debug("markUp");
 			emitter.emit("up", void 0);
 		}
 		return response;
@@ -72,10 +74,13 @@ function createHttpTransport(options = {}) {
 			markDown(error.message ?? "network");
 			return Promise.reject(error);
 		}
-		if (error.response.status === 401) emitter.emit("auth-error", {
-			status: 401,
-			message: extractMessage(error)
-		});
+		if (error.response.status === 401) {
+			logger?.debug(`auth-error 401 (${error.config?.url ?? "unknown-url"})`);
+			emitter.emit("auth-error", {
+				status: 401,
+				message: extractMessage(error)
+			});
+		}
 		return Promise.reject(error);
 	});
 	function markDown(reason) {
@@ -84,6 +89,7 @@ function createHttpTransport(options = {}) {
 				up: false,
 				lastError: reason
 			};
+			logger?.debug(`markDown (${reason})`);
 			emitter.emit("down", { reason });
 		}
 	}

package/dist/transports/nats.d.ts

@@ -1,3 +1,4 @@
+import { Logger } from '@camera.ui/logger';
 import { RPCClient } from '@camera.ui/rpc';
 import { TransportSpec } from '../core/types.js';
 import { Transport, Unsubscribe } from './contract.js';
@@ -11,9 +12,11 @@ export interface NatsTransportOptions {
     readonly reconnectionDelayMax?: number;
     readonly reconnectionRandomizationFactor?: number;
     readonly timeout?: number;
+    readonly connectTimeout?: number;
     readonly pingInterval?: number;
     readonly pingTimeout?: number;
     readonly maxPingOut?: number;
+    readonly logger?: Logger;
 }
 export type NatsClientListener = (client: RPCClient | null) => void;
 export interface NatsTransport extends Transport {

package/dist/transports/nats.js

@@ -30,9 +30,11 @@ function createNatsTransport(options = {}) {
 	const reconnectionDelayMax = options.reconnectionDelayMax ?? 5e3;
 	const reconnectionRandomizationFactor = options.reconnectionRandomizationFactor ?? .5;
 	const timeout = options.timeout ?? 1e4;
+	const connectTimeout = options.connectTimeout ?? 5e3;
 	const pingInterval = options.pingInterval ?? 25e3;
 	const pingTimeout = options.pingTimeout ?? 2e4;
 	const maxPingOut = options.maxPingOut ?? 1;
+	const logger = options.logger;
 	const emitter = new TransportEmitter();
 	const clientListeners = /* @__PURE__ */ new Set();
 	let proxy = null;
@@ -61,6 +63,7 @@ function createNatsTransport(options = {}) {
 	function markUp() {
 		if (status.up) return;
 		status = { up: true };
+		logger?.debug("markUp");
 		emitter.emit("up", void 0);
 	}
 	function markDown(reason) {
@@ -69,6 +72,7 @@ function createNatsTransport(options = {}) {
 			up: false,
 			lastError: reason
 		};
+		logger?.debug(`markDown (${reason})`);
 		emitter.emit("down", { reason });
 	}
 	function stopStatusMonitor() {
@@ -84,6 +88,7 @@ function createNatsTransport(options = {}) {
 			if (!iter) return;
 			for await (const event of iter) {
 				if (abort.signal.aborted) break;
+				logger?.debug(`status: ${event.type}${"server" in event && event.server ? ` server=${String(event.server)}` : ""}`);
 				switch (event.type) {
 					case "reconnect":
 						markUp();
@@ -114,6 +119,8 @@ function createNatsTransport(options = {}) {
 		markDown(message);
 	}
 	async function rebuildClient(target, epoch) {
+		logger?.debug(`rebuildClient start (epoch=${epoch})`);
+		const t0 = Date.now();
 		stopStatusMonitor();
 		pendingConnectAbort?.abort();
 		if (proxy) {
@@ -138,6 +145,7 @@ function createNatsTransport(options = {}) {
 			reconnectionDelayMax,
 			reconnectionRandomizationFactor,
 			timeout,
+			connectTimeout,
 			pingInterval,
 			pingTimeout,
 			maxPingOut,
@@ -152,7 +160,9 @@ function createNatsTransport(options = {}) {
 				next.abortClose();
 			} catch {}
 			if (disposed || epoch !== applyEpoch) return;
-			markDown(err instanceof Error ? err.message : String(err));
+			const msg = err instanceof Error ? err.message : String(err);
+			logger?.debug(`rebuildClient connect FAILED after ${Date.now() - t0}ms: ${msg}`);
+			markDown(msg);
 			throw err;
 		} finally {
 			if (pendingConnectAbort === connectAbort) pendingConnectAbort = null;
@@ -164,6 +174,7 @@ function createNatsTransport(options = {}) {
 			return;
 		}
 		proxy = next;
+		logger?.debug(`rebuildClient connected in ${Date.now() - t0}ms`);
 		markUp();
 		notifyClient();
 		startStatusMonitor(next);
@@ -237,11 +248,24 @@ function createNatsTransport(options = {}) {
 	}
 	async function probeAlive(timeoutMs = 5e3) {
 		if (!proxy) throw new Error("nats-transport: no client");
-		await proxy.flush(timeoutMs);
+		const t0 = Date.now();
+		try {
+			await proxy.flush(timeoutMs);
+			logger?.debug(`probeAlive OK in ${Date.now() - t0}ms`);
+		} catch (err) {
+			logger?.debug(`probeAlive FAILED after ${Date.now() - t0}ms: ${err instanceof Error ? err.message : String(err)}`);
+			throw err;
+		}
 	}
 	async function forceReconnect() {
-		if (!proxy) return;
+		if (!proxy) {
+			logger?.debug("forceReconnect: no client");
+			return;
+		}
+		logger?.debug(`forceReconnect: issuing (up=${status.up} stale=${proxy.isStale})`);
+		const t0 = Date.now();
 		await proxy.forceReconnect();
+		logger?.debug(`forceReconnect: returned after ${Date.now() - t0}ms (up=${status.up})`);
 	}
 	return {
 		spec,

package/dist/transports/socketio.d.ts

@@ -1,4 +1,5 @@
 import { Manager, Socket } from 'socket.io-client';
+import { Logger } from '@camera.ui/logger';
 import { TransportSpec } from '../core/types.js';
 import { Transport } from './contract.js';
 export type { Socket };
@@ -10,6 +11,7 @@ export interface SocketioTransportOptions {
     readonly reconnectionDelay?: number;
     readonly reconnectionDelayMax?: number;
     readonly timeout?: number;
+    readonly logger?: Logger;
 }
 export interface SocketioTransport extends Transport {
     readonly manager: Manager | null;

package/dist/transports/socketio.js

@@ -18,6 +18,7 @@ function createSocketioTransport(options = {}) {
 	const reconnectionDelay = options.reconnectionDelay ?? 1e3;
 	const reconnectionDelayMax = options.reconnectionDelayMax ?? 5e3;
 	const timeout = options.timeout ?? 2e4;
+	const logger = options.logger;
 	const emitter = new TransportEmitter();
 	const sockets = /* @__PURE__ */ new Map();
 	let manager = null;
@@ -37,6 +38,7 @@ function createSocketioTransport(options = {}) {
 	function markUp() {
 		if (status.up) return;
 		status = { up: true };
+		logger?.debug("markUp");
 		emitter.emit("up", void 0);
 	}
 	function markDown(reason) {
@@ -45,6 +47,7 @@ function createSocketioTransport(options = {}) {
 			up: false,
 			lastError: reason
 		};
+		logger?.debug(`markDown (${reason})`);
 		emitter.emit("down", { reason });
 	}
 	function isAuthError(msg) {
@@ -73,6 +76,7 @@ function createSocketioTransport(options = {}) {
 		socket.on("disconnect", (reason) => markDown(reason));
 		socket.on("connect_error", (err) => {
 			const msg = err?.message ?? "connect_error";
+			logger?.debug(`connect_error (main): ${msg}`);
 			if (isAuthError(msg)) {
 				emitter.emit("auth-error", { message: msg });
 				return;
@@ -179,10 +183,13 @@ function createSocketioTransport(options = {}) {
 	function reviveDeadSockets() {
 		if (!currentTarget) return;
 		const auth = buildAuth(currentTarget);
+		let revived = 0;
 		for (const sock of sockets.values()) if (!sock.connected) {
 			sock.auth = auth;
 			sock.connect();
+			revived++;
 		}
+		logger?.debug(`reviveDeadSockets: ${revived}/${sockets.size} reconnecting`);
 	}
 	return {
 		get spec() {

package/dist/transports/ws.d.ts

@@ -1,3 +1,4 @@
+import { Logger } from '@camera.ui/logger';
 import { TransportSpec } from '../core/types.js';
 import { PerResourceTransport, Unsubscribe } from './contract.js';
 export interface WsHandleSpec {
@@ -27,6 +28,7 @@ export interface WsTransportOptions {
     readonly webSocketCtor?: typeof WebSocket;
     readonly tokenParam?: string;
     readonly sessionParam?: string;
+    readonly logger?: Logger;
 }
 export interface WsTransport extends PerResourceTransport<WsHandle, WsHandleSpec> {
     readonly handleCount: number;

package/dist/transports/ws.js

@@ -16,6 +16,7 @@ function createWsTransport(options = {}) {
 	const tokenParam = options.tokenParam ?? "token";
 	const sessionParam = options.sessionParam ?? "session";
 	const WsCtor = options.webSocketCtor ?? (typeof WebSocket !== "undefined" ? WebSocket : void 0);
+	const logger = options.logger;
 	const emitter = new TransportEmitter();
 	const handles = /* @__PURE__ */ new Set();
 	const closeDelivered = /* @__PURE__ */ new WeakSet();
@@ -45,6 +46,7 @@ function createWsTransport(options = {}) {
 	function bindWs(handle, ws) {
 		ws.onopen = () => {
 			if (handle.disposed || handle.ws !== ws) return;
+			logger?.debug(`open ${handle.spec.path}`);
 			if (!status.up) {
 				status = { up: true };
 				emitter.emit("up", void 0);
@@ -60,6 +62,7 @@ function createWsTransport(options = {}) {
 			if (closeDelivered.has(ws)) return;
 			closeDelivered.add(ws);
 			if (!isCurrent) return;
+			logger?.debug(`close ${handle.spec.path} code=${event.code} clean=${event.wasClean}${event.reason ? ` reason=${event.reason}` : ""}`);
 			if (isAuthCloseEvent(event)) emitter.emit("auth-error", { message: event.reason || `ws close code ${event.code}` });
 			const info = {
 				code: event.code,
@@ -112,6 +115,7 @@ function createWsTransport(options = {}) {
 	}
 	function recycleAll(code, reason) {
 		const snapshot = [...handles];
+		logger?.debug(`recycleAll (${reason}) handles=${snapshot.length}`);
 		for (const handle of snapshot) closeWs(handle, code, reason);
 		if (status.up) {
 			status = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camera.ui/transport",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "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",
@@ -56,7 +56,7 @@
   },
   "dependencies": {
     "@camera.ui/logger": ">=0.0.3",
-    "@camera.ui/rpc": ">=1.0.8",
+    "@camera.ui/rpc": ">=1.0.9",
     "axios": ">=1.18.1",
     "socket.io-client": ">=4.8.3"
   },