feat(desktop): add startup and onboarding flow

Add phase-based desktop boot progress, fresh-install sandbox testing, and first-run provider credential onboarding so packaged installs can start cleanly without manual settings detours.
2026-05-07 22:33:44 -04:00
parent fc9d18b03f
commit 89d5ee4b10
17 changed files with 1056 additions and 145 deletions
@@ -0,0 +1,90 @@
+import { atom } from 'nanostores'
+
+import type { DesktopBootProgress } from '@/global'
+
+export interface DesktopBootState extends DesktopBootProgress {
+  visible: boolean
+}
+
+const INITIAL_BOOT_STATE: DesktopBootState = {
+  error: null,
+  fakeMode: false,
+  message: 'Starting Hermes Desktop…',
+  phase: 'renderer.init',
+  progress: 2,
+  running: true,
+  timestamp: Date.now(),
+  visible: true
+}
+
+export const $desktopBoot = atom<DesktopBootState>(INITIAL_BOOT_STATE)
+
+function clampProgress(value: number) {
+  if (!Number.isFinite(value)) {
+    return 0
+  }
+
+  return Math.max(0, Math.min(100, Math.round(value)))
+}
+
+export function applyDesktopBootProgress(progress: DesktopBootProgress) {
+  const current = $desktopBoot.get()
+  const nextProgress = clampProgress(progress.progress)
+  const mergedProgress = progress.running ? Math.max(current.progress, nextProgress) : nextProgress
+
+  $desktopBoot.set({
+    ...current,
+    ...progress,
+    error: progress.error ?? null,
+    progress: mergedProgress,
+    visible: progress.running || mergedProgress < 100 || Boolean(progress.error)
+  })
+}
+
+export function setDesktopBootStep(step: {
+  phase: string
+  message: string
+  progress: number
+  running?: boolean
+  fakeMode?: boolean
+  error?: string | null
+}) {
+  const current = $desktopBoot.get()
+  applyDesktopBootProgress({
+    error: step.error ?? null,
+    fakeMode: step.fakeMode ?? current.fakeMode,
+    message: step.message,
+    phase: step.phase,
+    progress: step.progress,
+    running: step.running ?? true,
+    timestamp: Date.now()
+  })
+}
+
+export function completeDesktopBoot(message = 'Hermes Desktop is ready') {
+  const current = $desktopBoot.get()
+  $desktopBoot.set({
+    ...current,
+    error: null,
+    message,
+    phase: 'renderer.ready',
+    progress: 100,
+    running: false,
+    timestamp: Date.now(),
+    visible: false
+  })
+}
+
+export function failDesktopBoot(message: string) {
+  const current = $desktopBoot.get()
+  $desktopBoot.set({
+    ...current,
+    error: message,
+    message: `Desktop boot failed: ${message}`,
+    phase: 'renderer.error',
+    progress: clampProgress(current.progress),
+    running: false,
+    timestamp: Date.now(),
+    visible: true
+  })
+}