fix: add a neutral linked desktop hook for plugins (#1580)

packages/plugin-sdk/ui.api.txt

@@ -584,6 +584,7 @@ useChooseTheme (value): () => (themeId: string) => void
 useConfirm (value): () => (options: ConfirmOptions) => Promise<boolean>
 useConnectionGate (value): () => ConnectionGateController
 useConnectionLog (value): () => ConnectionLogContextType
+useDesktopLinked (value): () => boolean
 useDesktopUpdate (value): () => DesktopUpdateState
 useEditorDefaultKeys (value): () => Map<string, EditorDefaultKey>
 useHostActions (value): () => HostActionDef[]

scripts/check-sdk-ui-exports.cjs

@@ -605,6 +605,7 @@ const ALLOWED = [
   "useConfirm",
   "useConnectionGate",
   "useConnectionLog",
+  "useDesktopLinked",
   "useDesktopUpdate",
   "useEditorDefaultKeys",
   "useHostActions",

src/ui/lib/linked-server.ts

@@ -1,3 +1,4 @@
+import { useEffect, useState } from "react";
 import { isElectron } from "@/lib/electron";
 import { authApi } from "@/main-axios";
 import { SYNC_CHANGED_EVENT } from "@/lib/sync-events";
@@ -48,3 +49,22 @@ export function notifySyncChanged(): void {
   cached = null;
   window.dispatchEvent(new CustomEvent(SYNC_CHANGED_EVENT));
 }
+
+/** Whether this desktop is linked to a server, kept current as it changes. */
+export function useDesktopLinked(): boolean {
+  const [linked, setLinked] = useState(false);
+  useEffect(() => {
+    let live = true;
+    const read = () =>
+      void getLinkedSession().then((session) => {
+        if (live) setLinked(!!session);
+      });
+    read();
+    window.addEventListener(SYNC_CHANGED_EVENT, read);
+    return () => {
+      live = false;
+      window.removeEventListener(SYNC_CHANGED_EVENT, read);
+    };
+  }, []);
+  return linked;
+}

src/ui/plugin-host/sdk-ui.ts

@@ -574,7 +574,7 @@ export {
   invalidateServerStatusCache,
 } from "@/lib/hosts-request-cache";
 export { reportBetaFeedbackUrl, reportCoreIssueUrl } from "@/lib/issue-url";
-export { notifySyncChanged } from "@/lib/linked-server";
+export { notifySyncChanged, useDesktopLinked } from "@/lib/linked-server";
 export {
   clearLocalAdaptivePreferences,
   getPreferredHostAction,