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.