@camera.ui/browser 0.1.12 → 0.1.13

package/dist/index.d.ts

@@ -1389,9 +1389,11 @@ export declare type StreamStatus = 'idle' | 'connecting' | 'connected' | 'reconn
 
 export declare interface TerminalManagerInterface {
     createSession(options?: TerminalOptions): Promise<TerminalSessionInfo>;
+    listSessions(): Promise<TerminalSessionInfo[]>;
     generateOutput(sessionId: string): AsyncGenerator<Uint8Array>;
     writeInput(sessionId: string, data: string): Promise<void>;
     resize(sessionId: string, dimensions: { cols: number; rows: number }): Promise<void>;
+    updateSession(sessionId: string, update: TerminalSessionUpdate): Promise<void>;
     closeSession(sessionId: string): Promise<void>;
 }
 
@@ -1406,12 +1408,21 @@ export declare interface TerminalOptions {
     cwd?: string;
     shell?: string;
     env?: Record<string, string>;
+    name?: string;
+    persistent?: boolean;
 }
 
 export declare interface TerminalSessionInfo {
     sessionId: string;
     pid: number;
     dimensions: { cols: number; rows: number };
+    name?: string;
+    persistent: boolean;
+}
+
+declare interface TerminalSessionUpdate {
+    name?: string;
+    persistent?: boolean;
 }
 
 declare type TrainingBoxSource = 'object' | 'static' | 'extra' | 'face' | 'plate' | 'suggestion' | 'drawn' | 'copied';
@@ -1632,7 +1643,10 @@ export declare interface UseTabVisibilityReturn {
 export declare function useTerminal(): UseTerminalReturn;
 
 export declare interface UseTerminalOptions extends TerminalOptions {
+    sessionId?: string;
     onData?: (data: Uint8Array) => void;
+    onReplay?: () => void;
+    onSession?: (session: TerminalSessionInfo) => void;
     onClose?: () => void;
     onError?: (error: Error) => void;
 }
@@ -1647,13 +1661,23 @@ export declare interface UseTerminalReturn {
         cols: number;
         rows: number;
     }>>;
+    persistent: Readonly<Ref<boolean>>;
     connect: (options?: UseTerminalOptions) => Promise<void>;
     write: (data: string) => Promise<void>;
     resize: (dimensions: {
         cols: number;
         rows: number;
     }) => Promise<void>;
+    setPersistent: (persistent: boolean) => Promise<void>;
+    rename: (name: string) => Promise<void>;
     close: () => Promise<void>;
+    terminate: () => Promise<void>;
+}
+
+export declare function useTerminalSessions(): UseTerminalSessionsReturn;
+
+export declare interface UseTerminalSessionsReturn {
+    list: () => Promise<TerminalSessionInfo[]>;
 }
 
 export declare function useTopmostFullscreenElement(): ComputedRef<HTMLElement | null>;

package/dist/index.js

@@ -6729,7 +6729,6 @@ function useCoreManager() {
 function useTerminal() {
 	const cameraUi = useCameraUi();
 	const { rpc, isConnected: isClientConnected } = cameraUi;
-	const namespaces = NamespaceManager.terminalManagerNamespaces();
 	const sessionId = shallowRef();
 	const isConnected = ref(false);
 	const isConnecting = ref(false);
@@ -6738,6 +6737,7 @@ function useTerminal() {
 		cols: 80,
 		rows: 24
 	});
+	const persistent = ref(false);
 	let streamAbortController;
 	let currentOptions;
 	let streamGen = 0;
@@ -6745,28 +6745,28 @@ function useTerminal() {
 	let streamClient;
 	let wentOffline = false;
 	let keptAcrossBlip = false;
-	const proxy = (r) => r.createProxy(namespaces.terminalManagerRpc);
 	async function connect(options) {
 		if (isConnecting.value || isConnected.value) return;
 		isConnecting.value = true;
 		error.value = void 0;
 		currentOptions = options;
 		try {
-			const session = await rpcCall(rpc, (r) => proxy(r).createSession({
-				cols: options?.cols ?? 80,
-				rows: options?.rows ?? 24,
-				cwd: options?.cwd,
-				shell: options?.shell,
-				env: options?.env
-			}), { maxRetries: 0 });
+			const { session, attached } = await openSession(options);
 			sessionId.value = session.sessionId;
 			dimensions.value = session.dimensions;
+			persistent.value = session.persistent;
 			isConnected.value = true;
+			options?.onSession?.(session);
 			streamAbortController = new AbortController();
 			wentOffline = false;
 			keptAcrossBlip = false;
 			const gen = ++streamGen;
+			if (attached) options?.onReplay?.();
 			consumeOutputStream(session.sessionId, options, gen);
+			if (attached && options?.cols && options.rows) resize({
+				cols: options.cols,
+				rows: options.rows
+			});
 		} catch (err) {
 			error.value = err instanceof Error ? err : new Error(String(err));
 			options?.onError?.(error.value);
@@ -6774,11 +6774,32 @@ function useTerminal() {
 			isConnecting.value = false;
 		}
 	}
+	async function openSession(options) {
+		if (options?.sessionId) {
+			const session = (await rpcCall(rpc, (r) => terminalProxy(r).listSessions())).find((candidate) => candidate.sessionId === options.sessionId);
+			if (session) return {
+				session,
+				attached: true
+			};
+		}
+		return {
+			session: await rpcCall(rpc, (r) => terminalProxy(r).createSession({
+				cols: options?.cols ?? 80,
+				rows: options?.rows ?? 24,
+				cwd: options?.cwd,
+				shell: options?.shell,
+				env: options?.env,
+				name: options?.name,
+				persistent: options?.persistent
+			}), { maxRetries: 0 }),
+			attached: false
+		};
+	}
 	async function consumeOutputStream(sid, options, gen) {
 		try {
 			const current = rpc.value;
 			if (!current) return;
-			const output = proxy(current).generateOutput(sid);
+			const output = terminalProxy(current).generateOutput(sid);
 			stream = output;
 			streamClient = current;
 			for await (const chunk of output) {
@@ -6797,37 +6818,50 @@ function useTerminal() {
 		} finally {
 			if (gen === streamGen && !streamAbortController?.signal.aborted) {
 				isConnected.value = false;
-				closeRemote(sid);
+				if (!persistent.value) closeRemote(sid);
 				options?.onClose?.();
 			}
 		}
 	}
 	async function write(data) {
-		if (!sessionId.value || !isConnected.value) return;
-		try {
-			await rpcCall(rpc, (r) => proxy(r).writeInput(sessionId.value, data));
-		} catch (err) {
-			error.value = err instanceof Error ? err : new Error(String(err));
-			currentOptions?.onError?.(error.value);
-		}
+		await callSession((api, sid) => api.writeInput(sid, data));
 	}
 	async function resize(dims) {
-		if (!sessionId.value || !isConnected.value) return;
+		if (await callSession((api, sid) => api.resize(sid, dims))) dimensions.value = dims;
+	}
+	async function setPersistent(value) {
+		persistent.value = value;
+		await update({ persistent: value });
+	}
+	async function rename(name) {
+		await update({ name });
+	}
+	function update(change) {
+		return callSession((api, sid) => api.updateSession(sid, change));
+	}
+	async function callSession(call) {
+		const sid = sessionId.value;
+		if (!sid || !isConnected.value) return false;
 		try {
-			await rpcCall(rpc, (r) => proxy(r).resize(sessionId.value, dims));
-			dimensions.value = dims;
+			await rpcCall(rpc, (r) => call(terminalProxy(r), sid));
+			return true;
 		} catch (err) {
 			error.value = err instanceof Error ? err : new Error(String(err));
 			currentOptions?.onError?.(error.value);
+			return false;
 		}
 	}
 	async function close() {
 		stopStream();
-		if (sessionId.value) await closeRemote(sessionId.value);
+		if (sessionId.value && !persistent.value) await closeRemote(sessionId.value);
 		sessionId.value = void 0;
 		isConnected.value = false;
 		currentOptions = void 0;
 	}
+	async function terminate() {
+		persistent.value = false;
+		await close();
+	}
 	function stopStream() {
 		streamAbortController?.abort();
 		streamGen++;
@@ -6837,7 +6871,7 @@ function useTerminal() {
 		keptAcrossBlip = false;
 	}
 	function closeRemote(sid) {
-		return rpcCall(rpc, (r) => proxy(r).closeSession(sid), {
+		return rpcCall(rpc, (r) => terminalProxy(r).closeSession(sid), {
 			awaitConnect: false,
 			maxRetries: 0
 		}).catch(() => void 0);
@@ -6845,13 +6879,18 @@ function useTerminal() {
 	function restart() {
 		const savedOptions = currentOptions;
 		const sid = sessionId.value;
+		const keep = persistent.value;
 		stopStream();
-		if (sid) closeRemote(sid);
+		if (sid && !keep) closeRemote(sid);
 		sessionId.value = void 0;
 		isConnected.value = false;
 		currentOptions = void 0;
 		savedOptions?.onClose?.();
-		if (savedOptions) connect(savedOptions);
+		if (savedOptions) connect({
+			...savedOptions,
+			sessionId: keep ? sid : void 0,
+			persistent: keep
+		});
 	}
 	function handleReconnected() {
 		if (!sessionId.value && !isConnected.value) return;
@@ -6878,10 +6917,21 @@ function useTerminal() {
 		isClientConnected: readonly(isClientConnected),
 		error: readonly(error),
 		dimensions: readonly(dimensions),
+		persistent: readonly(persistent),
 		connect,
 		write,
 		resize,
-		close
+		setPersistent,
+		rename,
+		close,
+		terminate
 	};
 }
-export { CAMERA_UI_INJECTION_KEY, NamespaceManager, STREAM_CONFIG, acquireSensorManager, clearCameraCache, clearOAuthCache, clearPluginCache, clearSensorCache, clearSnapshotCache, clearStorageCache, createActivityMode, createCameraUiPlugin, createReactiveCameraDevice, createSensorManager, getSnapshotUrl, isReactiveAudioSensor, isReactiveBatteryInfo, isReactiveCarbonDioxideInfo, isReactiveCarbonMonoxideSensor, isReactiveClassifierSensor, isReactiveColdSensor, isReactiveContactSensor, isReactiveDoorbellTrigger, isReactiveFaceSensor, isReactiveGarageControl, isReactiveGasSensor, isReactiveHeatSensor, isReactiveHumidityInfo, isReactiveIlluminanceInfo, isReactiveLeakSensor, isReactiveLicensePlateSensor, isReactiveLightControl, isReactiveLockControl, isReactiveMotionSensor, isReactiveObjectSensor, isReactiveOccupancySensor, isReactivePTZControl, isReactivePowerSensor, isReactiveProblemSensor, isReactiveSecuritySystem, isReactiveSirenControl, isReactiveSmokeSensor, isReactiveSwitchControl, isReactiveTamperSensor, isReactiveTemperatureInfo, isReactiveVibrationSensor, refreshClientSubscriptions, releaseSensorManager, resetClientState, restartConnectedStreams, rpcCall, setFullscreenRoot, useAllSensors, useAudioSensor, useCameraById, useCameraStorage, useCameraStream, useCameraUi, useClassifierSensors, useCoreManager, useCuiFullscreen, useDeviceManager, useFaceSensor, useLicensePlateSensor, useMotionSensor, useOAuth, useObjectSensor, usePTZControl, usePlugin, usePluginStorage, useRpcCall, useRpcSubscription, useSensorById, useSensorByType, useSensorStorage, useSensors, useSensorsByType, useSnapshot, useTabVisibility, useTerminal, useTopmostFullscreenElement };
+function useTerminalSessions() {
+	const { rpc } = useCameraUi();
+	return { list: () => rpcCall(rpc, (r) => terminalProxy(r).listSessions()) };
+}
+function terminalProxy(r) {
+	return r.createProxy(NamespaceManager.terminalManagerNamespaces().terminalManagerRpc);
+}
+export { CAMERA_UI_INJECTION_KEY, NamespaceManager, STREAM_CONFIG, acquireSensorManager, clearCameraCache, clearOAuthCache, clearPluginCache, clearSensorCache, clearSnapshotCache, clearStorageCache, createActivityMode, createCameraUiPlugin, createReactiveCameraDevice, createSensorManager, getSnapshotUrl, isReactiveAudioSensor, isReactiveBatteryInfo, isReactiveCarbonDioxideInfo, isReactiveCarbonMonoxideSensor, isReactiveClassifierSensor, isReactiveColdSensor, isReactiveContactSensor, isReactiveDoorbellTrigger, isReactiveFaceSensor, isReactiveGarageControl, isReactiveGasSensor, isReactiveHeatSensor, isReactiveHumidityInfo, isReactiveIlluminanceInfo, isReactiveLeakSensor, isReactiveLicensePlateSensor, isReactiveLightControl, isReactiveLockControl, isReactiveMotionSensor, isReactiveObjectSensor, isReactiveOccupancySensor, isReactivePTZControl, isReactivePowerSensor, isReactiveProblemSensor, isReactiveSecuritySystem, isReactiveSirenControl, isReactiveSmokeSensor, isReactiveSwitchControl, isReactiveTamperSensor, isReactiveTemperatureInfo, isReactiveVibrationSensor, refreshClientSubscriptions, releaseSensorManager, resetClientState, restartConnectedStreams, rpcCall, setFullscreenRoot, useAllSensors, useAudioSensor, useCameraById, useCameraStorage, useCameraStream, useCameraUi, useClassifierSensors, useCoreManager, useCuiFullscreen, useDeviceManager, useFaceSensor, useLicensePlateSensor, useMotionSensor, useOAuth, useObjectSensor, usePTZControl, usePlugin, usePluginStorage, useRpcCall, useRpcSubscription, useSensorById, useSensorByType, useSensorStorage, useSensors, useSensorsByType, useSnapshot, useTabVisibility, useTerminal, useTerminalSessions, useTopmostFullscreenElement };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camera.ui/browser",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "camera.ui browser client",
   "author": "seydx (https://github.com/cameraui/clients)",
   "type": "module",
@@ -61,7 +61,7 @@
     "typescript": "5.9.3",
     "typescript-eslint": "^8.72.1",
     "unplugin-dts": "^1.1.2",
-    "updates": "^20.0.0",
+    "updates": "^20.0.1",
     "vite": "^8.3.6",
     "vitest": "^5.1.0",
     "vue": "^3.5.45",