seahaven-ap/packages/api/docs/local-dev.md
Adam Moussa 9d3646876e
feat(api): stand up Hono Drizzle foundation with auth and Redocly (AP-14) (#12)
* feat(api): stand up Hono Drizzle foundation with auth and Redocly

* fix(api): bump drizzle-orm and hono node-server past audit highs

* fix(api): harden auth upsert and Cognito token verification
2026-08-11 00:10:49 +00:00

859 B

Local development

Data plane

docker compose up -d
npm run db:migrate
npm run db:seed
npm run dev:api

Defaults:

  • Postgres at postgresql://seahaven:seahaven@127.0.0.1:5432/seahaven_ap
  • API at http://127.0.0.1:8787
  • MinIO at http://127.0.0.1:9000 (documents bucket for AP-15)

Smoke

curl -s http://127.0.0.1:8787/health
curl -s http://127.0.0.1:8787/api/me

With DEV_AUTH_BYPASS=true and NODE_ENV=development (or test), /api/me does not require a Bearer token. Bypass is rejected for staging, preview, production, and any other NODE_ENV.

Docs

npm run lint:api
npm run docs:preview

docs:preview runs redocly build-docs (CLI v2) and opens the HTML at /tmp/seahaven-ap-api-docs.html. Published OpenAPI servers point at https://ap.seahaven.com. Use this page for the local docs view.