## API Error Handling (final)

Five error types, five distinct response strategies:

  TimeoutError    (AbortError): Request exceeded timeout threshold.
                        Show 'server is slow' message. Offer retry.
                        For writes: warn that action may have completed.

  RateLimitError  (429): User or client has exceeded the request limit.
                        Show wait-time message. Do NOT retry immediately.

  ForbiddenError  (403): User does not have permission.
                        Show permission message. Do NOT retry.

  ApiError        (4xx, 5xx): Network or server error.
                        Show retry-prompting message.

  ValidationError (schema): API response shape changed.
                        Log to Sentry. Show 'please update the app'.

Default request timeout: 10 seconds (DEFAULT_TIMEOUT_MS in lib/api.ts).
Override per-call with options.timeoutMs for operations with different SLAs.
Photo upload timeoutMs should be higher (60s) for large files on slow networks.
