Repository navigation
[skills] Sync auth with current docs - #316
Merged
Merged
Conversation
<!-- vercel-plugin-drift-agent -->
vercel-gh-bot-2
Bot
force-pushed
the
eve-drift/auth
branch
from
October 15, 2026 09:32
0c5cadb to
dbcf3f5
Compare
@clerk/nextjs v7 peers on next ^15.2.8 || ^15.3.8 || ^15.4.10 || ^15.5.9 || ^16.0.10, and Clerk corrected its upgrade guidance (clerk/javascript#9790).
molebox
approved these changes
Oct 19, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
@clerk/nextjs7.0.0 and 7.9.12 (latest) both declarepeerDependencies.nextas^15.2.8 || ^15.3.8 || ^15.4.10 || ^15.5.9 || ^15.6.0-0 || ^16.0.10 || ^16.1.0-0.Verification
run_plugin_checkspassed every step: build, typecheck, validate, and test (1079 pass, 0 fail).Test updates
None.
Not changed
https://vercel.com/oauth/authorize,https://api.vercel.com/login/oauth/token), PKCE/state/nonce, and token lifetimes (1 hour access, 30-day rotating refresh) all match https://vercel.com/docs/sign-in-with-vercel/authorization-server-api (last_updated 2026-08-21) and /tokens. The link checker flags the token endpoint as not a doc page; it is an API endpoint, not a link.signJWTresult shape,signTokenbeing deprecated, and 0.3.0+ all match https://vercel.com/docs/kms/ts-sdk-reference (2026-09-16) and the @vercel/kms CHANGELOG. The JWKS URLhttps://kms.vercel.com/<issuerId>/jwks.jsonmatches the authorization-server-api page. It is an API URL, not a doc page.Opened automatically by the vercel-plugin drift agent. Review before merge.
Drift scan update 2026-10-15
genericOAuth+connectfrom@vercel/connect/betterauth| —" says the adapter is for third-party tokens and impliesgenericOAuthcomes from@vercel/connect/betterauth. Corrected to "Sign in through a Vercel Connect connector |genericOAuthfrombetter-auth/plugins/generic-oauth+connectfrom@vercel/connect/betterauth| — (v1.7 signs in withauthClient.signIn.social;genericOAuthClientonly exists on v1.6 and earlier)". Source: https://vercel.com/docs/connect/frameworks/better-auth (last_updated 2026-09-18): "The@vercel/connect/betterauthadapter lets your application sign users in through a Vercel Connect connector." The page importsgenericOAuthfrom'better-auth/plugins/generic-oauth'. Its client step (genericOAuthClient,signIn.oauth2) matches better-auth 1.6. In better-auth 1.7.x (latest 1.7.9),genericOAuthClientis gone and generic OAuth providers usesignIn.social, so the Client column stays—with a v1.6 note. The shipped@vercel/connect2.5.2dist/betterauth/index.d.tsexports onlyconnectandConnectError, notgenericOAuth.@vercel/connect/betterauth)" now reads as a sign-in adapter, and the line notes that provider API tokens usegetToken(). Same page: "UsegetToken()from@vercel/connectwhen your server needs a scoped token for a provider API. Do not send the access token stored by Better Auth's generic OAuth account to the provider API." Thevercel-connectskill already describes@vercel/connect/betterauthas sign-in.Verification
run_plugin_checks: build, typecheck, validate, and test all passed (1079 tests pass, 0 fail).Test updates
None.
Not changed
@clerk/nextjs7.9.15,@descope/nextjs-sdk0.16.13). Their docs sites are outside the Vercel docs estate. The Clerk "Minimum Next.js version: 15.2.3" line is a Core 3 (March 2026) note. The current@clerk/nextjspeer range starts at^15.2.8. I left the line alone.check_linksflaggedhttps://api.vercel.com/login/oauth/tokenandhttps://kms.vercel.com/. Both are API endpoints that the Sign in with Vercel and KMS docs document, not doc pages, so they are not dead links.Opened automatically by the vercel-plugin drift agent. Review before merge.
Update (@molebox)
The 2026-10-15 force-push dropped the Clerk change described in the first section. It is restored in 6574712: "Minimum Next.js version: 15.2.8 (or 16.0.10 on Next.js 16); later 15.x minors need their patched releases too (15.3.8+, 15.4.10+, 15.5.9+)". Re-checked against
@clerk/nextjs@7.9.17(latest), whosepeerDependencies.nextis^15.2.8 || ^15.3.8 || ^15.4.10 || ^15.5.9 || ^15.6.0-0 || ^16.0.10 || ^16.1.0-0, and Clerk's upgrade CHANGELOG (clerk/javascript#9790). The "Not changed" note that says the line was left alone is superseded.tests/auth-skill.test.tsandvalidatepass.