feat: Electron desktop app — hardening, IPC bridge, and dev launch fixes

- Dev/prod URL auto-detection (Vite 5173 in dev, server 3000 in prod) - Typed IPC bridge via preload (notifications, badge, window controls, updates, deep links) - Native OS notifications via NotificationController with window focus suppression - Auto-update via electron-updater with UpdateToast UI - Deep linking (backspace:// protocol) for macOS and Windows/Linux - Window state persistence (position, size, maximize across restarts) - Tray icon with graceful fallback when icon asset missing - Suppress PWA service worker polling/reloads inside Electron - Platform detection layer (isElectron, getElectronAPI) - Root workspace scripts (dev:desktop, build:desktop) - Document BACKSPACE_URL and BACKSPACE_UPDATE_URL env vars
2026-03-16 00:10:47 +01:00
parent 56811b9333
commit 8ae3ffc912
17 changed files with 743 additions and 85 deletions
@@ -0,0 +1,49 @@
+import { useEffect } from 'react';
+import { useNavigate } from 'react-router-dom';
+import { isElectron } from './platform';
+
+/**
+ * Listens for deep link events from the Electron main process and navigates accordingly.
+ *
+ * Supported routes:
+ *   backspace://join/{code}            → /join/{code}
+ *   backspace://join/{code}@{host}     → /join/{code}@{host}
+ *   backspace://channel/{spaceId}/{channelId} → /channels/{spaceId}/{channelId}
+ */
+export function useDeepLinkHandler(): void {
+  const navigate = useNavigate();
+
+  useEffect(() => {
+    if (!isElectron()) return;
+
+    const api = window.backspace!;
+    api.onDeepLink((url: string) => {
+      let parsed: URL;
+      try {
+        parsed = new URL(url);
+      } catch {
+        console.warn('[DeepLink] Invalid URL:', url);
+        return;
+      }
+
+      if (parsed.protocol !== 'backspace:') return;
+
+      // URL host + pathname gives us the route
+      // backspace://join/code  → host="join", pathname="/code"
+      // backspace://channel/spaceId/channelId → host="channel", pathname="/spaceId/channelId"
+      const host = parsed.hostname;
+      const pathParts = parsed.pathname.split('/').filter(Boolean);
+
+      if (host === 'join' && pathParts.length >= 1) {
+        const code = pathParts[0]!;
+        navigate(`/join/${code}`);
+      } else if (host === 'channel' && pathParts.length >= 2) {
+        const spaceId = pathParts[0]!;
+        const channelId = pathParts[1]!;
+        navigate(`/channels/${spaceId}/${channelId}`);
+      } else {
+        console.warn('[DeepLink] Unknown route:', url);
+      }
+    });
+  }, [navigate]);
+}