chore(backend,nextjs): Introduce treatPendingAsSignedOut option to server-side utilities and control components

[LauraBeatris]

Description

Allow passing treatPendingAsSignedOut to auth, getAuth, and server-side control components.

If session status is pending:

// Returns signed out object by default
const { userId } = auth()

// Treats as signed-in
const { userId } = auth({ treatPendingAsSignedOut: false })

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: 897334b

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

This PR includes changesets to release 1 package

Name	Type
@clerk/nextjs	Minor

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	May 5, 2025 8:32pm