You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

45 lines
1.7 KiB
Markdown

+++
title = "Implement API client module — typed fetch wrappers for all quotesdb-api endpoints"
priority = 7
status = "todo"
ticket_type = "task"
dependencies = ["c3503b", "93515e"]
+++
<context>
The `quotesdb` UI is a Yew (Rust → Wasm) single-page app compiled by Trunk and hosted on Cloudflare Pages. It communicates with the backend API via `fetch` calls. Source lives in `src/bin/ui/`. Run with `trunk serve` for local development.
The API client module provides typed fetch wrappers around all quotesdb-api endpoints. The UI calls these functions from page components rather than making raw fetch calls directly.
</context>
<goal>
Implement `src/bin/ui/api.rs` (or `src/bin/ui/client.rs`) with async functions for each endpoint:
- `list_quotes(page, author, tag) -> Result<ListResponse>`
- `get_quote(id) -> Result<Quote>`
- `get_random_quote() -> Result<Quote>`
- `create_quote(body) -> Result<CreateResponse>`
- `update_quote(id, auth_code, body) -> Result<Quote>`
- `delete_quote(id, auth_code) -> Result<()>`
Each function sets the appropriate headers (including `X-Auth-Code` where needed) and deserialises the response.
</goal>
<constraints>
- Use `gloo::net::http` or `web_sys::fetch` for HTTP requests (not reqwest — not available in WASM).
- Resolve TRIAGE ticket a9534d (CORS and Trunk proxy config) — during `trunk serve`, the API URL may differ.
- All functions must be `async` and return `Result` with a meaningful error type.
- The base URL should be configurable (env var at compile time or from `window.location.origin`).
</constraints>
<validation>
From the `quotesdb/` directory:
```sh
trunk build
```
</validation>
<commit>
`feat(quotesdb): implement typed API client module for all quotesdb-api endpoints`
</commit>