Skip to content

reacttodo.md

Latest commit

 

History

History
97 lines (82 loc) · 6.12 KB

reacttodo.md

File metadata and controls

97 lines (82 loc) · 6.12 KB

meow-decoder Mobile App — React Native Build Tracker

Status Legend

  • Not started
  • Complete
  • [~] In progress

Phase 1 — Types & Validation Layer

  • src/types/capture.ts — CaptureRequest, CapturedFrame, CaptureResponse, CaptureState
  • src/types/navigation.ts — Navigation param types for React Navigation
  • src/services/requestValidator.ts — Zod schemas, validateRequest()
  • src/services/qrDecoder.ts — parseQRPayload(), validateBase64(), opaque data handling

Phase 2 — Constants & Utils

  • src/constants/config.ts — Timeouts, thresholds, FOUNTAIN_OVERHEAD, GIF detection params
  • src/constants/theme.ts — Colors, fonts, cat-themed palette
  • src/utils/base64.ts — isValidBase64(), estimateDecodedBytes() — no actual decode
  • src/utils/formatters.ts — formatElapsed(), formatPercent(), formatFileSize()

Phase 3 — Services Layer

  • src/services/frameCollector.ts — FrameCollector class, dedup, size tracking
  • src/services/jsonExporter.ts — exportResponse(), chunked export at 5MB boundary

Phase 4 — Hooks Layer

  • src/hooks/useCapture.ts — Full state machine reducer (IDLE→CAPTURING→COMPLETE)
  • src/hooks/useQRScanner.ts — Vision Camera frame processor, GIF auto-detection
  • src/hooks/useStabilityMonitor.ts — Accelerometer shake detection
  • src/hooks/useSessionManager.ts — Progress calculations, recoverability metrics

Phase 5 — Components Layer

  • src/components/CameraPreview.tsx — Vision Camera wrapper with frame processor
  • src/components/ProgressHUD.tsx — Progress bar, frame count, recoverability labels
  • src/components/FrameOverlay.tsx — QR bounding box, status badges
  • src/components/StabilityIndicator.tsx — Shake/blur warning overlay
  • src/components/CatToast.tsx — Themed notification toasts with cat sounds

Phase 6 — Screens Layer

  • src/screens/SplashScreen.tsx — Animated cat logo, version display
  • src/screens/OnboardingScreen.tsx — First-run: air-gap explanation, camera permission
  • src/screens/HomeScreen.tsx — Load capture request or manual session entry
  • src/screens/CaptureScreen.tsx — Camera preview + overlay + progress HUD
  • src/screens/ExportScreen.tsx — Review results, save JSON, QR fallback display

Phase 7 — App Entry & Navigation

  • src/App.tsx — Navigation container, theme provider, AppState lifecycle
  • src/navigation/AppNavigator.tsx — Stack navigator wiring all screens

Phase 8 — Project Config

  • package.json — All dependencies per spec (vision-camera, zod, reanimated, etc.)
  • tsconfig.json — Strict TypeScript config with node/jest types for mocks
  • .eslintrc.js — ESLint + Prettier rules
  • babel.config.js — Reanimated plugin, worklets support

Phase 9 — Tests

  • __tests__/captureReducer.test.ts — All state transition tests
  • __tests__/requestValidator.test.ts — Zod validation edge cases
  • __tests__/frameCollector.test.ts — Dedup and accumulation tests
  • __tests__/jsonExporter.test.ts — Export and chunking tests
  • __tests__/formatters.test.ts — Utility formatter tests
  • __tests__/base64.test.ts — Base64 validation tests
  • __tests__/qrDecoder.test.ts — QR payload parsing tests
  • __tests__/webDemoIntegration.test.ts — Web demo wire format integration

Phase 10 — Platform & README

  • android/app/src/main/AndroidManifest.xml — Camera-only permissions
  • ios/MeowCapture/Info.plist — NSCameraUsageDescription
  • README.md — Full updated README per spec

Phase 11 — TypeScript Strict Compliance (tsc --noEmit clean)

  • tsconfig.json — Add node/jest to types for mock files and Buffer in tests
  • src/constants/config.ts — Fix as const on arithmetic expression (not a literal)
  • src/hooks/useQRScanner.ts — Replace deprecated Worklets.createRunInJsFn (typed never) with useRunOnJS hook
  • src/hooks/useStabilityMonitor.ts — Fix Accelerometer class (doesn't exist) → accelerometer Observable + typed SensorData
  • src/hooks/useSessionManager.ts — Fix exactOptionalPropertyTypes violation on sessionId
  • src/components/CameraPreview.tsx — Fix FrameProcessor (not exported) → ReadonlyFrameProcessor
  • src/components/ProgressHUD.tsx — Fix strokeDashoffset (SVG-only, not in DefaultStyle) → RN-native animated width bar
  • src/services/jsonExporter.ts — Fix TextEncoder (not in ES2022 lib) → Buffer.byteLength
  • src/services/qrDecoder.ts — Fix exactOptionalPropertyTypes violation on session_id return
  • src/screens/CaptureScreen.tsx — Remove unused setQrActive, qrActiveTimer
  • src/screens/ExportScreen.tsx — Remove unused progressColor import
  • src/screens/HomeScreen.tsx — Remove unused Alert; fix result possibly-undefined
  • src/screens/SplashScreen.tsx — Remove unused runOnJS, FIRST_LAUNCH_KEY
  • __tests__/jsonExporter.test.ts — Remove total_frames (not in CaptureResponse type)
  • __tests__/requestValidator.test.ts — Remove unused CaptureRequestSchema import

Security Invariants (cross-check on each phase)

  • No network permissions in any manifest (AndroidManifest — no INTERNET; Info.plist — NSAppTransportSecurity blocks all; network_security_config.xml — all cleartext blocked)
  • No frame data written to disk except during explicit export (state lives in React useReducer; AppState listener dispatches RESET on background)
  • No crypto keys or passwords ever referenced in app code (app is capture-only; decryption happens on desktop)
  • All incoming JSON validated with Zod before processing (CaptureRequestSchema.strict() in requestValidator.ts)
  • AppState background handler clears frame data from memory (useCapture.ts AppState addEventListener dispatches RESET)
  • No any type escapes in TypeScript (tsconfig strict + @typescript-eslint/no-explicit-any as ESLint error)
  • No console.log(frameData) or similar data leaks in production paths (no-console as ESLint error in .eslintrc.js)