Privacy & Telemetry
diff --git a/src/hooks/useFeatureFlag.test.ts b/src/hooks/useFeatureFlag.test.ts
new file mode 100644
index 00000000..4800f4cb
--- /dev/null
+++ b/src/hooks/useFeatureFlag.test.ts
@@ -0,0 +1,70 @@
+import { describe, it, expect, vi } from 'vitest'
+import { renderHook } from '@testing-library/react'
+import { useFeatureFlag } from './useFeatureFlag'
+
+describe('useFeatureFlag', () => {
+ it('returns false for example_flag by default', () => {
+ vi.spyOn(globalThis, 'localStorage', 'get').mockReturnValue({
+ getItem: () => null,
+ setItem: () => {},
+ removeItem: () => {},
+ clear: () => {},
+ length: 0,
+ key: () => null,
+ })
+ const { result } = renderHook(() => useFeatureFlag('example_flag'))
+ expect(result.current).toBe(false)
+ vi.restoreAllMocks()
+ })
+
+ it('returns true when localStorage override is set to "true"', () => {
+ vi.spyOn(globalThis, 'localStorage', 'get').mockReturnValue({
+ getItem: (key: string) => key === 'ff_example_flag' ? 'true' : null,
+ setItem: () => {},
+ removeItem: () => {},
+ clear: () => {},
+ length: 0,
+ key: () => null,
+ })
+ const { result } = renderHook(() => useFeatureFlag('example_flag'))
+ expect(result.current).toBe(true)
+ vi.restoreAllMocks()
+ })
+
+ it('returns false when localStorage override is set to "false"', () => {
+ vi.spyOn(globalThis, 'localStorage', 'get').mockReturnValue({
+ getItem: (key: string) => key === 'ff_example_flag' ? 'false' : null,
+ setItem: () => {},
+ removeItem: () => {},
+ clear: () => {},
+ length: 0,
+ key: () => null,
+ })
+ const { result } = renderHook(() => useFeatureFlag('example_flag'))
+ expect(result.current).toBe(false)
+ vi.restoreAllMocks()
+ })
+
+ it('ignores non-boolean localStorage values (treats as false)', () => {
+ vi.spyOn(globalThis, 'localStorage', 'get').mockReturnValue({
+ getItem: (key: string) => key === 'ff_example_flag' ? 'maybe' : null,
+ setItem: () => {},
+ removeItem: () => {},
+ clear: () => {},
+ length: 0,
+ key: () => null,
+ })
+ const { result } = renderHook(() => useFeatureFlag('example_flag'))
+ expect(result.current).toBe(false)
+ vi.restoreAllMocks()
+ })
+
+ it('falls back to default when localStorage throws', () => {
+ vi.spyOn(globalThis, 'localStorage', 'get').mockImplementation(() => {
+ throw new Error('localStorage disabled')
+ })
+ const { result } = renderHook(() => useFeatureFlag('example_flag'))
+ expect(result.current).toBe(false)
+ vi.restoreAllMocks()
+ })
+})
diff --git a/src/hooks/useFeatureFlag.ts b/src/hooks/useFeatureFlag.ts
new file mode 100644
index 00000000..b1da55db
--- /dev/null
+++ b/src/hooks/useFeatureFlag.ts
@@ -0,0 +1,26 @@
+/**
+ * Local feature flag hook (V1 — no remote fetching).
+ *
+ * Flags are resolved in order:
+ * 1. localStorage override (`ff_`) — for dev/QA testing
+ * 2. Compile-time defaults in FLAG_DEFAULTS
+ *
+ * To add a new flag: add its name to the FeatureFlagName union and
+ * set its default in FLAG_DEFAULTS.
+ */
+
+export type FeatureFlagName = 'example_flag'
+
+const FLAG_DEFAULTS: Record = {
+ example_flag: false,
+}
+
+export function useFeatureFlag(flag: FeatureFlagName): boolean {
+ try {
+ const override = localStorage.getItem(`ff_${flag}`)
+ if (override !== null) return override === 'true'
+ } catch {
+ // localStorage may be unavailable in some contexts
+ }
+ return FLAG_DEFAULTS[flag] ?? false
+}
diff --git a/src/hooks/useSettings.test.ts b/src/hooks/useSettings.test.ts
index 06c7d5e6..d87da8a6 100644
--- a/src/hooks/useSettings.test.ts
+++ b/src/hooks/useSettings.test.ts
@@ -14,6 +14,7 @@ const defaultSettings: Settings = {
crash_reporting_enabled: null,
analytics_enabled: null,
anonymous_id: null,
+ update_channel: null,
}
const savedSettings: Settings = {
@@ -27,6 +28,7 @@ const savedSettings: Settings = {
crash_reporting_enabled: null,
analytics_enabled: null,
anonymous_id: null,
+ update_channel: null,
}
let mockSettingsStore: Settings = { ...defaultSettings }
@@ -92,6 +94,7 @@ describe('useSettings', () => {
crash_reporting_enabled: null,
analytics_enabled: null,
anonymous_id: null,
+ update_channel: null,
}
await act(async () => {
diff --git a/src/hooks/useSettings.ts b/src/hooks/useSettings.ts
index 3f1c95e4..b9ac5e89 100644
--- a/src/hooks/useSettings.ts
+++ b/src/hooks/useSettings.ts
@@ -18,6 +18,7 @@ const EMPTY_SETTINGS: Settings = {
crash_reporting_enabled: null,
analytics_enabled: null,
anonymous_id: null,
+ update_channel: null,
}
export function useSettings() {
diff --git a/src/hooks/useTelemetry.test.ts b/src/hooks/useTelemetry.test.ts
index 5af723c6..e676e32c 100644
--- a/src/hooks/useTelemetry.test.ts
+++ b/src/hooks/useTelemetry.test.ts
@@ -19,7 +19,7 @@ const baseSettings: Settings = {
anthropic_key: null, openai_key: null, google_key: null,
github_token: null, github_username: null, auto_pull_interval_minutes: null,
telemetry_consent: null, crash_reporting_enabled: null,
- analytics_enabled: null, anonymous_id: null,
+ analytics_enabled: null, anonymous_id: null, update_channel: null,
}
describe('useTelemetry', () => {
diff --git a/src/hooks/useUpdater.test.ts b/src/hooks/useUpdater.test.ts
index d50f599c..01310dfe 100644
--- a/src/hooks/useUpdater.test.ts
+++ b/src/hooks/useUpdater.test.ts
@@ -25,6 +25,11 @@ vi.mock('@tauri-apps/plugin-process', () => ({
relaunch: (...args: unknown[]) => mockRelaunch(...args),
}))
+const mockGetVersion = vi.fn().mockResolvedValue('0.20260101.1')
+vi.mock('@tauri-apps/api/app', () => ({
+ getVersion: () => mockGetVersion(),
+}))
+
import { isTauri } from '../mock-tauri'
describe('useUpdater', () => {
@@ -200,6 +205,42 @@ describe('useUpdater', () => {
expect(mockDownload).toHaveBeenCalled()
})
+ describe('canary channel', () => {
+ it('fetches latest-canary.json when channel is canary', async () => {
+ vi.mocked(isTauri).mockReturnValue(true)
+ mockGetVersion.mockResolvedValue('0.20260101.1')
+
+ const mockFetch = vi.mocked(globalThis.fetch)
+ mockFetch.mockResolvedValueOnce(new Response(JSON.stringify({
+ version: '0.20260325.99-canary',
+ notes: 'Canary build',
+ platforms: {
+ 'darwin-aarch64': {
+ url: 'https://github.com/refactoringhq/laputa-app/releases/download/v0.20260325.99-canary/laputa.app.tar.gz',
+ signature: 'sig123',
+ },
+ },
+ }), { status: 200 }))
+
+ const { result } = renderHook(() => useUpdater('canary'))
+
+ let checkResult: string | undefined
+ await act(async () => {
+ checkResult = await result.current.actions.checkForUpdates()
+ })
+
+ expect(checkResult).toBe('available')
+ expect(result.current.status).toEqual({
+ state: 'available',
+ version: '0.20260325.99-canary',
+ notes: 'Canary build',
+ })
+ expect(mockFetch).toHaveBeenCalledWith(
+ 'https://refactoringhq.github.io/laputa-app/latest-canary.json'
+ )
+ })
+ })
+
describe('checkForUpdates (manual)', () => {
it('returns up-to-date when no update is available', async () => {
vi.mocked(isTauri).mockReturnValue(true)
diff --git a/src/hooks/useUpdater.ts b/src/hooks/useUpdater.ts
index d8632063..d239e276 100644
--- a/src/hooks/useUpdater.ts
+++ b/src/hooks/useUpdater.ts
@@ -3,6 +3,7 @@ import { isTauri } from '../mock-tauri'
import { openExternalUrl } from '../utils/url'
const RELEASE_NOTES_URL = 'https://refactoringhq.github.io/laputa-app/'
+const CANARY_ENDPOINT = 'https://refactoringhq.github.io/laputa-app/latest-canary.json'
export type UpdateStatus =
| { state: 'idle' }
@@ -20,14 +21,45 @@ export interface UpdateActions {
dismiss: () => void
}
-export function useUpdater(): { status: UpdateStatus; actions: UpdateActions } {
+interface CanaryRelease {
+ version: string
+ notes: string
+ platforms: Record
+}
+
+async function checkCanaryUpdate(): Promise<{ version: string; notes: string; downloadUrl: string } | null> {
+ const response = await fetch(CANARY_ENDPOINT)
+ if (!response.ok) return null
+
+ const data = await response.json() as CanaryRelease
+ const { getVersion } = await import('@tauri-apps/api/app')
+ const currentVersion = await getVersion()
+
+ if (data.version === currentVersion) return null
+
+ const platform = data.platforms['darwin-aarch64']
+ const downloadUrl = platform?.url?.replace(/\.tar\.gz$/, '').replace(/\.app$/, '') ?? ''
+
+ return { version: data.version, notes: data.notes, downloadUrl }
+}
+
+export function useUpdater(channel: string | null = null): { status: UpdateStatus; actions: UpdateActions } {
const [status, setStatus] = useState({ state: 'idle' })
const updateRef = useRef(null)
+ const canaryUrlRef = useRef(null)
const checkForUpdates = useCallback(async (): Promise => {
if (!isTauri()) return 'up-to-date'
try {
+ if (channel === 'canary') {
+ const canary = await checkCanaryUpdate()
+ if (!canary) return 'up-to-date'
+ canaryUrlRef.current = canary.downloadUrl
+ setStatus({ state: 'available', version: canary.version, notes: canary.notes })
+ return 'available'
+ }
+
const { check } = await import('@tauri-apps/plugin-updater')
const update = await check()
if (!update) return 'up-to-date'
@@ -43,7 +75,7 @@ export function useUpdater(): { status: UpdateStatus; actions: UpdateActions } {
console.warn('[updater] Failed to check for updates')
return 'error'
}
- }, [])
+ }, [channel])
useEffect(() => {
if (!isTauri()) return
@@ -52,6 +84,12 @@ export function useUpdater(): { status: UpdateStatus; actions: UpdateActions } {
}, [checkForUpdates])
const startDownload = useCallback(async () => {
+ // Canary: open the GitHub release page for manual download
+ if (canaryUrlRef.current) {
+ openExternalUrl(canaryUrlRef.current)
+ return
+ }
+
const update = updateRef.current as {
version: string
downloadAndInstall: (cb: (event: { event: string; data?: { contentLength?: number; chunkLength?: number } }) => void) => Promise
diff --git a/src/mock-tauri/mock-handlers.ts b/src/mock-tauri/mock-handlers.ts
index 111dd11e..e7151724 100644
--- a/src/mock-tauri/mock-handlers.ts
+++ b/src/mock-tauri/mock-handlers.ts
@@ -85,6 +85,7 @@ let mockSettings: Settings = {
crash_reporting_enabled: null,
analytics_enabled: null,
anonymous_id: null,
+ update_channel: null,
}
let mockLastVaultPath: string | null = null
@@ -206,6 +207,7 @@ export const mockHandlers: Record any> = {
crash_reporting_enabled: s.crash_reporting_enabled,
analytics_enabled: s.analytics_enabled,
anonymous_id: s.anonymous_id,
+ update_channel: s.update_channel,
}
return null
},
diff --git a/src/types.ts b/src/types.ts
index a1f77117..7bb6b5fe 100644
--- a/src/types.ts
+++ b/src/types.ts
@@ -81,6 +81,7 @@ export interface Settings {
crash_reporting_enabled: boolean | null
analytics_enabled: boolean | null
anonymous_id: string | null
+ update_channel: string | null
}
export interface GitPullResult {