Mobile: Native storage abstraction (Capacitor Preferences)

[krusty-agent]

Overview

This PR adds a native storage abstraction layer that provides a unified interface for both web and native platforms:

• Web: Uses localStorage (synchronous)
• Native (iOS/Android): Uses Capacitor Preferences (async, secure native storage)

Changes

New Files

• src/lib/storageAdapter.ts: Low-level async storage adapter

  • WebStorage: Wraps localStorage in async API for web
  • NativeStorage: Uses Capacitor Preferences on native platforms
  • Auto-detects platform using Capacitor.isNativePlatform()

• src/lib/STORAGE_MIGRATION.md: Migration guide and documentation

  • Explains the storage abstraction
  • Provides migration examples
  • Lists files marked for future migration

Modified Files

• package.json: Added @capacitor/preferences dependency
• src/lib/storage.ts: Added TODO comments for migration
• src/hooks/useAuth.tsx: Added TODO comments for migration
• src/lib/webvh.ts: Added TODO comments for migration

Strategy

Rather than breaking existing code, this PR:

1. Creates the storage abstraction infrastructure
2. Marks existing localStorage usage with TODO comments
3. Provides a clear migration path for future PRs

This allows:

• Existing synchronous code to keep working
• New code to use the async adapter
• Incremental migration of existing code

Testing

• ✅ Build passes (npm run build)
• ✅ Package installed successfully
• Ready for testing on native platforms

Next Steps

Future PRs can migrate existing code incrementally:

1. Settings (storage.ts) - Most impactful, easiest
2. WebVH Keys (webvh.ts) - Security-critical
3. Auth State (useAuth.tsx) - Complex, needs careful testing

Benefits

• Better security on native platforms (encrypted storage)
• Platform consistency across web and native
• Foundation for future platform support
• Respects OS-level privacy controls