Skip to content

feat: typed API client with retry, backoff, and debounce #24

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
PAMulligan merged 7 commits into from
Mar 21, 2026
Merged

feat: typed API client with retry, backoff, and debounce #24

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
a398f7b
docs: add typed API client implementation plan
Mar 21, 2026
f0a2a8c
feat: add shared API types for chat client
Mar 21, 2026
a9a6db1
feat: add ChatApiError and DebounceError types with tests
Mar 21, 2026
18a3753
feat: add ChatApiClient with retry, backoff, and debounce
Mar 21, 2026
b277241
feat: export API client and types from widget package
Mar 21, 2026
4033ee4
feat: integrate ChatApiClient into useChat hook
Mar 21, 2026
b43e2a8
docs: add API client section to CLAUDE.md
Mar 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -110,6 +110,15 @@ Manages chat state:
- `sendMessage(text)` - Send a message to the API
- `clearMessages()` - Clear chat history

### API Client

`ChatApiClient` in `widget/src/api/client.ts` handles communication with the Worker:
- Typed requests/responses (`ChatRequest`, `ChatResponse`)
- Retry on 429 (respects `Retry-After`) and 503 (exponential backoff: 1s, 3s)
- Max 2 retries (3 total attempts)
- Debounced sends (configurable, default 300ms)
- Typed errors (`ChatApiError` with status/code, `DebounceError`)

### Worker API

| Endpoint | Method | Description |
Expand Down
Loading
Loading