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.
vibed/quotesdb/.beans/quotesdb-4t5j--set-up-apisr...

48 lines
1.8 KiB
Markdown

---
# quotesdb-4t5j
title: Set up api/src/main.rs — Cloudflare Workers entry point and Axum router wiring
status: completed
type: task
priority: critical
created_at: 2026-03-10T23:32:08Z
updated_at: 2026-03-10T23:32:15Z
blocked_by:
- quotesdb-ghzc
---
<context>
The `quotesdb` API is built with Axum + Tokio, targeting Cloudflare Workers via `workers-rs`. It serves JSON at `/api/*` endpoints and persists data to Cloudflare D1 (production) or a local SQLite file via Turso (development). Source lives in `src/bin/api/`.
Shared types and utilities are in `src/lib.rs` — code placed there must compile for both the host target and `wasm32-unknown-unknown`.
</context>
<goal>
Implement `src/bin/api/main.rs` — the Cloudflare Workers entry point and Axum router wiring. Set up the router with all seven API routes in the correct order (`GET /api/quotes/random` before `GET /api/quotes/:id`), connect the SQLx database pool, and wire in the workers-rs event handler.
</goal>
<constraints>
- Route registration order is critical: `GET /api/quotes/random` must be registered **before** `GET /api/quotes/:id` or the random endpoint will never match.
- Provide a `#[cfg(not(target_env = "worker"))]` conditional for running the API as a plain Axum server during local `cargo run`, alongside the workers-rs event macro for Cloudflare deployment.
- Database pool initialisation must handle both Turso (local) and D1 (worker) connection strings.
</constraints>
<skills>
Use `superpowers:test-driven-development` — write integration test stubs in `tests/` before wiring up handlers.
Use `superpowers:verification-before-completion` before closing.
</skills>
<validation>
Run in order from the `quotesdb/` directory:
```sh
cargo fmt
cargo check
cargo clippy
cargo test
```
</validation>
<commit>
`feat(quotesdb): wire Axum router and workers-rs entry point in api main.rs`
</commit>