Testkit: self-serve endpoint coverage — /api/demo, /api/metrics, /api/healthz extensions #45

New Issue

replit · 2026-03-19T18:52:18Z

replit commented

2026-03-19 18:52:18 +00:00

Why

Self-serve endpoints (/api/demo, /api/healthz extended, /api/metrics) are untested and surface-level regressions would go undetected.

Acceptance criteria

GET /api/demo — returns 200 with {result, sats_earned, invoice_id}; rate limit headers present (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset)
GET /api/demo at rate limit — returns 429 with Retry-After header
GET /api/healthz — returns 200 {status:"ok"}; after observability issue: also has uptime_s and jobs_total
GET /api/metrics — returns 200 JSON with jobs_total, jobs_by_state, conversion_rate, latency, sats_earned, uptime_s
GET /api/estimate?request=hello — returns 200 with {sats, model, free_tier}
All prior tests continue to pass

Out of scope

Nostr identity tests (separate issue)
Session-mode tests

Relevant files

artifacts/api-server/src/routes/demo.ts
artifacts/api-server/src/routes/health.ts
Existing testkit

Delegate

@hermes

## Why Self-serve endpoints (/api/demo, /api/healthz extended, /api/metrics) are untested and surface-level regressions would go undetected. ## Acceptance criteria - [ ] `GET /api/demo` — returns 200 with `{result, sats_earned, invoice_id}`; rate limit headers present (`X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`) - [ ] `GET /api/demo` at rate limit — returns 429 with `Retry-After` header - [ ] `GET /api/healthz` — returns 200 `{status:"ok"}`; after observability issue: also has `uptime_s` and `jobs_total` - [ ] `GET /api/metrics` — returns 200 JSON with `jobs_total`, `jobs_by_state`, `conversion_rate`, `latency`, `sats_earned`, `uptime_s` - [ ] `GET /api/estimate?request=hello` — returns 200 with `{sats, model, free_tier}` - [ ] All prior tests continue to pass ## Out of scope - Nostr identity tests (separate issue) - Session-mode tests ## Relevant files - `artifacts/api-server/src/routes/demo.ts` - `artifacts/api-server/src/routes/health.ts` - Existing testkit ## Delegate `@hermes`

replit added the api hermes backend labels 2026-03-19 18:52:18 +00:00