The best way to control Claude Code, Codex and more from any computer or phone

main
ts 201 lines 7.15 KB
Raw
1 import type {
2 DesktopPreviewTabState,
3 PreviewReportStatusInput,
4 PreviewSessionSnapshot,
5 ScopedThreadRef,
6 ThreadId,
7 } from "@t3tools/contracts";
8 import { useEffect, useEffectEvent, useRef } from "react";
9
10 import { recordFaviconForThread } from "~/browserFaviconStore";
11 import { useBrowserPointerStore } from "~/browser/browserPointerStore";
12 import { acquireBrowserSurfaceActivity } from "~/browser/browserSurfaceStore";
13 import { applyPreviewDesktopState, type DesktopPreviewOverlay } from "~/previewStateStore";
14 import { previewEnvironment } from "~/state/preview";
15 import { useAtomCommand } from "~/state/use-atom-command";
16
17 import { previewBridge } from "./previewBridge";
18
19 function originOf(url: string): string | null {
20 try {
21 return new URL(url).origin;
22 } catch {
23 return null;
24 }
25 }
26
27 /**
28 * Keeps a hidden guest painting behind the app while the desktop host captures it; Electron
29 * composites no offscreen guest, so its screenshot or stream would otherwise never finish.
30 */
31 export function createCaptureActivity(tabId: string) {
32 let release: (() => void) | null = null;
33 const update = (capturing: boolean) => {
34 if (capturing && !release) release = acquireBrowserSurfaceActivity(tabId);
35 else if (!capturing && release) {
36 release();
37 release = null;
38 }
39 };
40 return { update, release: () => update(false) };
41 }
42
43 /** ElectronBrowserHost owns webview lifetime. */
44 export function usePreviewBridge(input: {
45 threadRef: ScopedThreadRef;
46 tabId: string;
47 runtimeTabId: string;
48 serverDriven?: boolean;
49 }): void {
50 const { threadRef, tabId, runtimeTabId, serverDriven = false } = input;
51 const clearBrowserPointer = useBrowserPointerStore((state) => state.clear);
52 const reportStatus = useAtomCommand(previewEnvironment.reportStatus, "preview status report");
53 const { environmentId, threadId } = threadRef;
54 const stableThreadRef: ScopedThreadRef = { environmentId, threadId };
55
56 const lastReportedUrl = useRef<string | null>(null);
57 const lastReportedKind = useRef<DesktopPreviewTabState["navStatus"]["kind"] | null>(null);
58 const lastReportedTitle = useRef<string | null>(null);
59 const lastDesktopNavStatus = useRef<DesktopPreviewTabState["navStatus"] | null>(null);
60 const captureActivity = useRef<ReturnType<typeof createCaptureActivity> | null>(null);
61 const handleStateChange = useEffectEvent(
62 (changedTabId: string, state: DesktopPreviewTabState): void => {
63 if (changedTabId !== runtimeTabId) return;
64 if (shouldClearBrowserPointer(lastDesktopNavStatus.current, state.navStatus)) {
65 clearBrowserPointer(runtimeTabId);
66 }
67 lastDesktopNavStatus.current = state.navStatus;
68 captureActivity.current?.update(state.capturing);
69 applyPreviewDesktopState(stableThreadRef, tabId, projectDesktopState(state));
70 if (state.favicon) {
71 recordFaviconForThread(stableThreadRef, state.favicon);
72 }
73 const reported = buildReportInput({
74 threadId: stableThreadRef.threadId,
75 tabId,
76 state,
77 lastReportedUrl: lastReportedUrl.current,
78 lastReportedKind: lastReportedKind.current,
79 lastReportedTitle: lastReportedTitle.current,
80 });
81 if (!reported || serverDriven) return;
82 lastReportedUrl.current = reported.lastReportedUrl;
83 lastReportedKind.current = reported.lastReportedKind;
84 lastReportedTitle.current = reported.lastReportedTitle;
85 void reportStatus({
86 environmentId: stableThreadRef.environmentId,
87 input: reported.input,
88 });
89 },
90 );
91 // oxlint-disable-next-line t3code/no-unreasoned-state-sync -- subscribes to preview bridge state changes and capture activity for the current tab
92 useEffect(() => {
93 if (!previewBridge || typeof window === "undefined") return;
94 lastReportedUrl.current = null;
95 lastReportedKind.current = null;
96 lastReportedTitle.current = null;
97 lastDesktopNavStatus.current = null;
98 const activity = createCaptureActivity(runtimeTabId);
99 captureActivity.current = activity;
100 const unsubscribe = previewBridge.onStateChange(handleStateChange);
101 return () => {
102 unsubscribe();
103 activity.release();
104 if (captureActivity.current === activity) captureActivity.current = null;
105 };
106 }, [
107 runtimeTabId,
108 // oxlint-disable-next-line react/exhaustive-effect-dependencies -- A different tab or thread starts its status reports and pointer tracking from scratch.
109 environmentId,
110 threadId,
111 tabId,
112 ]);
113 }
114
115 function shouldClearBrowserPointer(
116 previous: DesktopPreviewTabState["navStatus"] | null,
117 current: DesktopPreviewTabState["navStatus"],
118 ): boolean {
119 if (!previous) return false;
120 if (current.kind === "Loading" && previous.kind !== "Loading") return true;
121 if (current.kind === "Idle" || previous.kind === "Idle") return false;
122 return current.url !== previous.url;
123 }
124
125 function projectDesktopNavStatus(
126 status: DesktopPreviewTabState["navStatus"],
127 ): PreviewSessionSnapshot["navStatus"] {
128 switch (status.kind) {
129 case "Idle":
130 return { _tag: "Idle" };
131 case "LoadFailed":
132 return {
133 _tag: "LoadFailed",
134 url: status.url,
135 title: status.title,
136 code: status.code,
137 description: status.description,
138 };
139 default:
140 return { _tag: status.kind, url: status.url, title: status.title };
141 }
142 }
143
144 export function projectDesktopState(state: DesktopPreviewTabState): DesktopPreviewOverlay {
145 const navOrigin = state.navStatus.kind === "Idle" ? null : originOf(state.navStatus.url);
146 return {
147 hasWebContents: state.webContentsId !== null,
148 navStatus: projectDesktopNavStatus(state.navStatus),
149 canGoBack: state.canGoBack,
150 canGoForward: state.canGoForward,
151 loading: state.navStatus.kind === "Loading",
152 zoomFactor: state.zoomFactor,
153 pictureInPicture: state.pictureInPicture,
154 colorScheme: state.colorScheme,
155 audioMuted: state.audioMuted,
156 audible: state.audible,
157 controller: state.controller,
158 favicon: state.favicon && originOf(state.favicon.pageUrl) === navOrigin ? state.favicon : null,
159 };
160 }
161
162 export function buildReportInput(args: {
163 readonly threadId: ThreadId;
164 readonly tabId: string;
165 readonly state: DesktopPreviewTabState;
166 readonly lastReportedUrl: string | null;
167 readonly lastReportedKind: DesktopPreviewTabState["navStatus"]["kind"] | null;
168 readonly lastReportedTitle: string | null;
169 }): {
170 readonly input: PreviewReportStatusInput;
171 readonly lastReportedUrl: string;
172 readonly lastReportedKind: DesktopPreviewTabState["navStatus"]["kind"];
173 readonly lastReportedTitle: string;
174 } | null {
175 const { threadId, tabId, state, lastReportedUrl, lastReportedKind, lastReportedTitle } = args;
176 const status = state.navStatus;
177 if (status.kind === "Idle") return null;
178
179 const sameAsLast =
180 status.kind !== "LoadFailed" &&
181 status.kind === lastReportedKind &&
182 status.url === lastReportedUrl &&
183 status.title === lastReportedTitle;
184 if (sameAsLast) return null;
185
186 const base = {
187 threadId,
188 tabId,
189 canGoBack: state.canGoBack,
190 canGoForward: state.canGoForward,
191 };
192 return {
193 input: {
194 ...base,
195 navStatus: projectDesktopNavStatus(status),
196 },
197 lastReportedUrl: status.url,
198 lastReportedKind: status.kind,
199 lastReportedTitle: status.title,
200 };
201 }