Skip to content

Fill gaps in the API reference - #745

Draft
Nicolapps wants to merge 1 commit into
rebootfrom
nicolas/api-reference-missing-types
Draft

Nicolapps wants to merge 1 commit into
rebootfrom
nicolas/api-reference-missing-types

Conversation

@Nicolapps

Copy link
Copy Markdown
Member

Test agents found several holes in the generated API reference:

  • UserCallbacks had no page, though every attachUserCallbacks points to it. TypeDoc only documents exported types, and UserCallbacks, CreateUserFn and OnSignInFn were not exported from any entry point.
  • AuthClientConfig rendered as AuthClientConfigBase & object | AuthClientConfigBase & object, with none of its fields, because AuthClientConfigBase was not exported.
  • Result types such as SignInResult, SignUpResult, ChangePasswordResult and TokenBundle rendered as Infer<typeof signInResult>. TypeDoc prints a type alias as written, and the validator isn't exported.
  • The Customizing providers page was empty ("work in progress"). It wasn't in the sidebar but still appeared in llms-full.txt.

Changes:

  • The TypeDoc plugin of the docs now marks every type alias declared as Infer<...> with @useDeclaredType, so TypeDoc renders the resolved type with its fields. This fixes all 59 such aliases at once and removes about 60 TypeDoc warnings.
  • @convex-dev/auth/server exports the UserCallbacks, CreateUserFn and OnSignInFn types. @convex-dev/auth/browser exports AuthClientConfigBase, and the AuthClientConfig TSDoc now names the mode and authApi fields and links to the shared ones. These are type-only exports of types that public signatures already use.
  • The empty Customizing providers page is removed. Custom providers go through bindProvider, which is internal, so there is nothing public to document yet.

RefreshResult is handled separately (N-8). pnpm lint, pnpm typecheck, pnpm check:declarations and the docs build pass.

Tracking: Z-5 (Notion)

- Render type aliases declared as Infer<typeof validator> with the type
  TypeScript resolves, so result types such as SignInResult and
  TokenBundle list their fields instead of the unexported validator.
- Export the UserCallbacks, CreateUserFn and OnSignInFn types from
  @convex-dev/auth/server, so the attachUserCallbacks docs link to them.
- Export AuthClientConfigBase from @convex-dev/auth/browser and describe
  the mode and authApi fields in the AuthClientConfig TSDoc.
- Remove the empty Customizing providers page, which was not in the
  sidebar but still showed up in llms-full.txt.
@vercel

vercel Bot commented Oct 16, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
auth-v2 Ready Ready Preview Oct 16, 2026 12:15am UTC
1 Skipped Deployment
Project Deployment Actions Updated
convex-auth-docs Ignored Ignored Oct 16, 2026 12:15am UTC

Request Review

This branch was successfully deployed

1 active deployment
Preview – auth-v2 — 469aff48 Deployed Oct 16, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant