Files
tolaria/src/hooks/useOnboarding.ts
2026-04-07 23:28:02 +02:00

193 lines
5.6 KiB
TypeScript

import { useCallback, useEffect, useState } from 'react'
import { invoke } from '@tauri-apps/api/core'
import { isTauri, mockInvoke } from '../mock-tauri'
import { pickFolder } from '../utils/vault-dialog'
type OnboardingState =
| { status: 'loading' }
| { status: 'welcome'; defaultPath: string }
| { status: 'vault-missing'; vaultPath: string; defaultPath: string }
| { status: 'ready'; vaultPath: string }
type CreatingAction = 'template' | 'empty' | null
function tauriCall<T>(command: string, args: Record<string, unknown>): Promise<T> {
return isTauri() ? invoke<T>(command, args) : mockInvoke<T>(command, args)
}
const DISMISSED_KEY = 'laputa_welcome_dismissed'
interface PersistedVaultList {
vaults?: Array<{ label: string; path: string }>
active_vault?: string | null
hidden_defaults?: string[]
}
function wasDismissed(): boolean {
try {
return localStorage.getItem(DISMISSED_KEY) === '1'
} catch {
return false
}
}
function markDismissed(): void {
try {
localStorage.setItem(DISMISSED_KEY, '1')
} catch {
// localStorage may be unavailable in some contexts
}
}
function formatTemplateError(err: unknown): string {
const message =
typeof err === 'string'
? err
: err instanceof Error
? err.message
: `${err}`
if (
message.includes('already exists and is not empty')
|| message.includes('already exists and is not a directory')
|| message.includes('Failed to create parent directory')
|| message.includes('Target path is required')
) {
return message
}
return 'Could not download Getting Started vault. Check your connection and try again.'
}
async function clearMissingActiveVault(missingPath: string): Promise<void> {
try {
const list = await tauriCall<PersistedVaultList>('load_vault_list', {})
if (!list || list.active_vault !== missingPath) return
await tauriCall('save_vault_list', {
list: {
vaults: list.vaults ?? [],
active_vault: null,
hidden_defaults: list.hidden_defaults ?? [],
},
})
} catch {
// Best effort only — onboarding should still proceed
}
}
export function useOnboarding(initialVaultPath: string) {
const [state, setState] = useState<OnboardingState>({ status: 'loading' })
const [creatingAction, setCreatingAction] = useState<CreatingAction>(null)
const [error, setError] = useState<string | null>(null)
const [lastTemplatePath, setLastTemplatePath] = useState<string | null>(null)
useEffect(() => {
let cancelled = false
async function check() {
try {
const defaultPath = await tauriCall<string>('get_default_vault_path', {})
const exists = await tauriCall<boolean>('check_vault_exists', { path: initialVaultPath })
if (cancelled) return
if (exists) {
setState({ status: 'ready', vaultPath: initialVaultPath })
} else {
await clearMissingActiveVault(initialVaultPath)
if (cancelled) return
}
if (exists) {
return
}
if (wasDismissed()) {
// User previously dismissed — show vault-missing instead of welcome
setState({ status: 'vault-missing', vaultPath: initialVaultPath, defaultPath })
} else {
setState({ status: 'welcome', defaultPath })
}
} catch {
// If commands fail (e.g. mock mode), just proceed
if (!cancelled) setState({ status: 'ready', vaultPath: initialVaultPath })
}
}
check()
return () => { cancelled = true }
}, [initialVaultPath])
const createTemplateVault = useCallback(async (targetPath: string) => {
setCreatingAction('template')
setError(null)
setLastTemplatePath(targetPath)
try {
const vaultPath = await tauriCall<string>('create_getting_started_vault', { targetPath })
markDismissed()
setState({ status: 'ready', vaultPath })
} catch (err) {
setError(formatTemplateError(err))
} finally {
setCreatingAction(null)
}
}, [])
const handleCreateVault = useCallback(async () => {
const path = await pickFolder('Choose where to clone the Getting Started vault')
if (!path) return
await createTemplateVault(path)
}, [createTemplateVault])
const retryCreateVault = useCallback(async () => {
if (!lastTemplatePath) return
await createTemplateVault(lastTemplatePath)
}, [createTemplateVault, lastTemplatePath])
const handleCreateNewVault = useCallback(async () => {
try {
setError(null)
const path = await pickFolder('Choose where to create your vault')
if (!path) return
setCreatingAction('empty')
const vaultPath = await tauriCall<string>('create_empty_vault', { targetPath: path })
markDismissed()
setState({ status: 'ready', vaultPath })
} catch (err) {
setError(typeof err === 'string' ? err : `Failed to create vault: ${err}`)
} finally {
setCreatingAction(null)
}
}, [])
const handleOpenFolder = useCallback(async () => {
try {
setError(null)
const path = await pickFolder('Open vault folder')
if (!path) return
markDismissed()
setState({ status: 'ready', vaultPath: path })
} catch (err) {
setError(`Failed to open folder: ${err}`)
}
}, [])
const handleDismiss = useCallback(() => {
markDismissed()
setState({ status: 'ready', vaultPath: initialVaultPath })
}, [initialVaultPath])
return {
state,
creating: creatingAction !== null,
creatingAction,
error,
canRetryTemplate: !!error && !!lastTemplatePath && creatingAction === null,
handleCreateVault,
retryCreateVault,
handleCreateNewVault,
handleOpenFolder,
handleDismiss,
}
}