chore(shared,vue,nextjs,astro,clerk-react): Update useAuth to handle pending session as signed-out

[LauraBeatris]

Description

Part of ORGS-621

Allows to pass treatPendingAsSignedOut as an option to useAuth - refer to the following behavior when a session has a pending status:

// userId is undefined, since pending is treat as signed-out state (default behavior)
const { userId } = useAuth() 

// userId is defined, since pending is treat as signed-out state (opt-in behavior)
const { userId } = useAuth({ treatPendingAsSignedOut: true })

Globally changing the default:

<ClerkProvider treatPendingAsSignedOut={false} />

---

Example from Nuxt route middleware:

const isProtectedRoute = createRouteMatcher(['/dashboard(.*)', '/forum(.*)'])

export default defineNuxtRouteMiddleware((to) => {
  const { userId } = useAuth()

  // If the user has a pending session, they aren't allowed to access
  // the protected route and are redirected to the sign-in page
  // If the sign-in page renders `SignIn`, then it'll redirect to `/tasks` internal route on component mount
  if (!userId.value && isProtectedRoute(to)) {
    return navigateTo('/sign-in')
  }
})

Checklist

• pnpm test runs as expected.
• pnpm build runs as expected.
• (If applicable) JSDoc comments have been added or updated for any package exports
• (If applicable) Documentation has been updated

Type of change

• 🐛 Bug fix
• 🌟 New feature
• 🔨 Breaking change
• 📖 Refactoring / dependency upgrade / documentation
• other:

[changeset-bot]

🦋 Changeset detected

Latest commit: 2950332

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 19 packages

Name	Type
@clerk/astro	Minor
@clerk/vue	Minor
@clerk/nextjs	Patch
@clerk/shared	Patch
@clerk/clerk-react	Patch
@clerk/nuxt	Patch
@clerk/agent-toolkit	Patch
@clerk/backend	Patch
@clerk/chrome-extension	Patch
@clerk/clerk-js	Patch
@clerk/elements	Patch
@clerk/expo-passkeys	Patch
@clerk/clerk-expo	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/react-router	Patch
@clerk/remix	Patch
@clerk/tanstack-react-start	Patch
@clerk/testing	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
clerk-js-sandbox	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Apr 3, 2025 9:21pm

[LauraBeatris]

I'll spin up different changeset per package since <ClerkProvider treatPendingAsSignedOut={false} /> is specific to React