mirror of
https://github.com/better-auth/better-auth.git
synced 2026-10-19 23:53:17 -05:00
Gustavo Valverde
fac0988277
Makes the Zod schema the single source of truth for OpenAPI docs. Adds `response` and `errors` fields on `createAuthEndpoint` options so the schema you already declare drives the generated spec. Default emission is OpenAPI 3.1. Migrates all 31 core auth routes to delete the hand-written metadata.openapi.requestBody/parameters/responses blocks in favor of `response` Zod schemas and explicit `errors` arrays. A transitional fallback keeps unmigrated first-party plugins working (legacy OAS 3.0 `nullable: true` is auto-upgraded to 3.1 unions); it will be removed as per-plugin migration PRs land. Closes drift cases surfaced by the audit: /sign-in/social required fields mismatch, /sign-up/email missing AdditionalUserFieldsInput, invalid `nullable: true` on OAS 3.1 (#6691), $ref + sibling keys in 3.0 output.