feat(nextjs,astro,backend,types): 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 the pending task to be resolved 
    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	Mar 26, 2025 4:50pm

[changeset-bot]

🦋 Changeset detected

Latest commit: 5dca566

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

This PR includes changesets to release 22 packages

Name	Type
@clerk/backend	Minor
@clerk/nextjs	Minor
@clerk/astro	Minor
@clerk/types	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
@clerk/clerk-js	Patch
@clerk/elements	Patch
@clerk/expo-passkeys	Patch
@clerk/clerk-expo	Patch
@clerk/localizations	Patch
@clerk/clerk-react	Patch
@clerk/shared	Patch
@clerk/themes	Patch
@clerk/vue	Patch
@clerk/chrome-extension	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

[LauraBeatris]

FYI - I'm currently introducing unit tests for tasks redirection on clerkMiddleware.test.ts, I've forgot about it and only included integration tests at first

While I'm refactoring, some integration tests might start to fail here as well - I'll ping another review