// Five error types in lib/api.ts (Chapters 5, 12, 13, 17):

TimeoutError       // Request exceeded timeoutMs (default 10s)
                   // Server may still be processing. Offer retry.

RateLimitError     // 429 Too Many Requests
                   // retryAfterSeconds from Retry-After header.
                   // Never retry immediately. Show wait time.

ForbiddenError     // 403 Forbidden
                   // User not permitted. Never retry. Never re-login.

ApiError           // 4xx or 5xx
                   // Network or server error. Offer retry for 5xx.

ValidationError    // Zod schema mismatch
                   // API shape changed. Log to Sentry.
                   // Show 'please update the app' in production.
