fix(express): Allow property access on req.auth for backward compatibility

[wobsoriano]

Description

We have devs coming from clerk-sdk-node which followed our migration guide to Express which includes direct property access of auth object via req.auth. This PR allows both req.auth and req.auth() with deprecation message.

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: 43fef22

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

This PR includes changesets to release 1 package

Name	Type
@clerk/express	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 ↗︎

1 Skipped Deployment

Name	Status	Preview	Comments	Updated (UTC)
clerk-js-sandbox	⬜️ Skipped (Inspect)			May 25, 2025 0:53am

[wobsoriano]

!snapshot

[clerk-cookie]

Hey @wobsoriano - the snapshot version command generated the following package versions:

Package	Version
@clerk/agent-toolkit	0.0.39-snapshot.v20250523235137
@clerk/astro	2.8.1-snapshot.v20250523235137
@clerk/backend	1.33.1-snapshot.v20250523235137
@clerk/chrome-extension	2.4.9-snapshot.v20250523235137
@clerk/clerk-js	5.67.4-snapshot.v20250523235137
@clerk/elements	0.23.30-snapshot.v20250523235137
@clerk/clerk-expo	2.11.9-snapshot.v20250523235137
@clerk/expo-passkeys	0.3.7-snapshot.v20250523235137
@clerk/express	1.5.1-snapshot.v20250523235137
@clerk/fastify	2.2.22-snapshot.v20250523235137
@clerk/localizations	3.16.2-snapshot.v20250523235137
@clerk/nextjs	6.20.1-snapshot.v20250523235137
@clerk/nuxt	1.6.8-snapshot.v20250523235137
@clerk/clerk-react	5.31.7-snapshot.v20250523235137
@clerk/react-router	1.4.7-snapshot.v20250523235137
@clerk/remix	4.7.7-snapshot.v20250523235137
@clerk/shared	3.9.4-snapshot.v20250523235137
@clerk/tanstack-react-start	0.15.7-snapshot.v20250523235137
@clerk/testing	1.7.4-snapshot.v20250523235137
@clerk/themes	2.2.47-snapshot.v20250523235137
@clerk/types	4.59.2-snapshot.v20250523235137
@clerk/vue	1.8.5-snapshot.v20250523235137

Tip: Use the snippet copy button below to quickly install the required packages.
@clerk/agent-toolkit

npm i @clerk/[email protected] --save-exact

@clerk/astro

npm i @clerk/[email protected] --save-exact

@clerk/backend

npm i @clerk/[email protected] --save-exact

@clerk/chrome-extension

npm i @clerk/[email protected] --save-exact

@clerk/clerk-js

npm i @clerk/[email protected] --save-exact

@clerk/elements

npm i @clerk/[email protected] --save-exact

@clerk/clerk-expo

npm i @clerk/[email protected] --save-exact

@clerk/expo-passkeys

npm i @clerk/[email protected] --save-exact

@clerk/express

npm i @clerk/[email protected] --save-exact

@clerk/fastify

npm i @clerk/[email protected] --save-exact

@clerk/localizations

npm i @clerk/[email protected] --save-exact

@clerk/nextjs

npm i @clerk/[email protected] --save-exact

@clerk/nuxt

npm i @clerk/[email protected] --save-exact

@clerk/clerk-react

npm i @clerk/[email protected] --save-exact

@clerk/react-router

npm i @clerk/[email protected] --save-exact

@clerk/remix

npm i @clerk/[email protected] --save-exact

@clerk/shared

npm i @clerk/[email protected] --save-exact

@clerk/tanstack-react-start

npm i @clerk/[email protected] --save-exact

@clerk/testing

npm i @clerk/[email protected] --save-exact

@clerk/themes

npm i @clerk/[email protected] --save-exact

@clerk/types

npm i @clerk/[email protected] --save-exact

@clerk/vue

npm i @clerk/[email protected] --save-exact

[pkg-pr-new]

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@5995

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@5995

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@5995

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@5995

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@5995

@clerk/elements

npm i https://pkg.pr.new/@clerk/elements@5995

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@5995

@clerk/clerk-expo

npm i https://pkg.pr.new/@clerk/clerk-expo@5995

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@5995

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@5995

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@5995

@clerk/express

npm i https://pkg.pr.new/@clerk/express@5995

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@5995

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@5995

@clerk/remix

npm i https://pkg.pr.new/@clerk/remix@5995

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@5995

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@5995

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@5995

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@5995

@clerk/themes

npm i https://pkg.pr.new/@clerk/themes@5995

@clerk/types

npm i https://pkg.pr.new/@clerk/types@5995

@clerk/clerk-react

npm i https://pkg.pr.new/@clerk/clerk-react@5995

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@5995

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@5995

commit: 43fef22