fix(auth)!: always mount client session lifecycle

[onmax]

skipHydratedSsrGetSession currently avoids the duplicate client request by skipping rawClient.useSession() entirely. That also prevents Better Auth's session refresh manager from mounting, so focus, polling, online, and broadcast refresh stop working on hydrated SSR pages.

This keeps the existing opt-in and default behavior, but changes the optimized path to:

• hydrate Better Auth's real session atom from Nuxt's SSR state
• mount useSession() so Better Auth retains ownership of its refresh lifecycle
• satisfy only the module-tagged bootstrap lookup from the hydrated state, without upstream network I/O
• delegate later, competing, plugin, and manual session requests to the original fetch implementation

The bootstrap remains inside Better Fetch's normal hook and response pipeline. Its request identity survives supported plugin URL rewrites, query schema validation, and request-hook transformations. The controller is one-shot and fails closed if session fetching starts before Nuxt can arm it.

The docs now call out that the bootstrap response uses Nuxt's sanitized user and session shape, so the session token and custom top-level response fields remain unavailable until Better Auth's next native refresh.

Verification

• corepack pnpm exec vitest run --maxWorkers=2 — 324 tests passed
• focused session/config suite — 58 tests passed
• corepack pnpm typecheck
• corepack pnpm lint
• corepack pnpm prepack
• git diff --check

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
nuxt-better-auth-docs	Ready	Preview	Aug 24, 2026 11:33am

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/@nuxtjs/better-auth@412

commit: 591ae37

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	better-auth	591ae37	Commit Preview URL Branch Preview URL	Aug 24 2026, 11:34 AM