feat(nextjs,astro,backend): Redirect to tasks on auth.protect and auth.redirectToSignIn

[LauraBeatris]

Description

Resolves ORGS-582

If clerkMiddleware executes auth.protect(), by default it'll look for the sts on session claims and redirect to tasks.

The index path on SessionTasks performs a reload on the client session, to resolve the missing task resource and then proceeds redirecting to the next component route.

import { clerkMiddleware, createRouteMatcher } from '@clerk/nextjs/server';

const isProtectedRoute = createRouteMatcher(['/home(.*)'])

export default clerkMiddleware(async (auth, req) => {
  if (isProtectedRoute(req)) {
    // Navigates to tasks by default if the user session has pending status
    await auth.protect()
  }
})

export const config = {
  matcher: ['/((?!.*\\..*|_next).*)', '/', '/(api|trpc)(.*)'],
};

---

Behavior

CleanShot.2025-03-24.at.14.23.16.mp4

---

Inner workings

The server cannot redirect directly to the specific task URL, eg: /sign-in/tasks/add-organization since it only has the sts JWT claim.

It verifies if sts is pending, and if so, navigates to /sign-in/tasks. Once clerk-js loads, it verifies for the Clerk.session.currentTask and performs a further client-side navigation to the specific task route.

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:

[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 1, 2025 7:42pm

[changeset-bot]

🦋 Changeset detected

Latest commit: 2028869

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

This PR includes changesets to release 11 packages

Name	Type
@clerk/backend	Minor
@clerk/nextjs	Minor
@clerk/astro	Minor
@clerk/agent-toolkit	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/nuxt	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