# V2 Public API Surface

This directory is the app-local public API contract for V2. Next.js route
adapters under `apps/oshun/web/src/app/api/v2/` import these handlers so the
logic remains testable without a running web server.

Canonical documentation lives in `@oshun/openapi` at
`libs/openapi/v2/companion.yaml`; the route `GET /api/v2/openapi` serves the
same spec document for developer tooling.

The surface covers account-public player stats and match history, replay
metadata, second-screen coach streams, push subscriptions, tournament bracket
creation, tournament result reporting, leaderboard ingest, HMAC-signed match-end
webhooks, the open-source Discord bot template, and HMAC-signed micro-game
result validation for Companion and Web Hub rewards.

tournament bracket creation is handled by
`POST /api/v2/tournament/{tournamentId}/bracket`.
