The best way to control Claude Code, Codex and more from any computer or phone
| 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 | } |