## API Error Handling (updated)

Four error types, four distinct response strategies:

  RateLimitError  (429): User or client has exceeded the request limit.
                        Show wait-time message. NEVER retry immediately.
                        Set retryOn429: false on write operations.

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

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

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

Debounce all user-triggered read operations with useDebounce(value, 300).
Disable retryOn429 on all write operations (create, update, delete, upload).
