Skip to content

feat(backend): Add Frontend API proxy helpers #7602

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
brkalow wants to merge 23 commits into
base: main
Choose a base branch
from
Open

feat(backend): Add Frontend API proxy helpers #7602

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
5ae1734
feat: Add Frontend API proxy helpers for @clerk/backend, @clerk/nextj…
brkalow Jan 15, 2026
b6e0da7
test: Add tests for Frontend API proxy helpers
brkalow Jan 15, 2026
04ca626
test: Remove low-value Next.js proxy tests
brkalow Jan 15, 2026
dc1349e
feat: Add multi-domain support for Frontend API proxy
brkalow Jan 16, 2026
93feba5
fix: Improve proxy header handling and redirect rewriting
brkalow Jan 21, 2026
307789f
feat: Embed Frontend API proxy in clerkMiddleware for Express and Nex…
brkalow Jan 22, 2026
77f9869
docs: Update Express frontendApiProxy examples to use enabled: true
brkalow Jan 22, 2026
1c941f8
fix: Require explicit enabled: true for Express frontendApiProxy
brkalow Jan 22, 2026
427dad7
fix: Use path boundary check for proxy path matching
brkalow Jan 23, 2026
fb6b536
fix: Normalize proxy path by removing trailing slashes
brkalow Jan 23, 2026
7cf49a4
Merge branch 'main' into brkalow/clerk-proxy-helper
brkalow Feb 2, 2026
48ab31e
fix: Handle x-forwarded-host and x-forwarded-proto as arrays
brkalow Feb 2, 2026
fe3eebc
refactor: Export proxy from @clerk/nextjs/server instead of /proxy su…
brkalow Feb 2, 2026
82d436f
fix: Replace regex with loop for trailing slash removal
brkalow Feb 2, 2026
7752813
refactor: Simplify stripTrailingSlashes using endsWith
brkalow Feb 3, 2026
9c54ee1
refactor: Move Next.js proxy module into server directory
brkalow Feb 9, 2026
7663c8c
fix: Fix CI failures for exports snapshot, test assertion, and missin…
brkalow Feb 9, 2026
b3eccb1
refactor: Remove DEFAULT_PROXY_PATH from @clerk/nextjs/server exports
brkalow Feb 9, 2026
4dae2f9
fix: Fix import sorting in Express and clear mock between proxy tests
brkalow Feb 9, 2026
05d1fd5
fix: Handle comma-separated x-forwarded-proto and x-forwarded-host he…
brkalow Feb 9, 2026
78f01a3
fix: Strip query string from Express proxy path matching
brkalow Feb 9, 2026
eedc6d4
fix: Remove unused variable in proxy test
brkalow Feb 9, 2026
f6f4ab3
fix: Fix import sorting in Next.js proxy types and tests
brkalow Feb 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions .changeset/frontend-api-proxy.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
'@clerk/backend': minor
'@clerk/nextjs': minor
'@clerk/express': minor
---
Copy link
Member

@jacekradko jacekradko Feb 10, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
---
'@clerk/shared': minor
---


Add Frontend API proxy support via `frontendApiProxy` option in `clerkMiddleware`
13 changes: 12 additions & 1 deletion packages/backend/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -75,6 +75,16 @@
"default": "./dist/webhooks.js"
}
},
"./proxy": {
"import": {
"types": "./dist/proxy.d.ts",
"default": "./dist/proxy.mjs"
},
"require": {
"types": "./dist/proxy.d.ts",
"default": "./dist/proxy.js"
}
},
"./package.json": "./package.json"
},
"main": "./dist/index.js",
Expand All @@ -83,7 +93,8 @@
"errors",
"internal",
"jwt",
"webhooks"
"webhooks",
"proxy"
],
"scripts": {
"build": "tsup",
Expand Down
5 changes: 5 additions & 0 deletions packages/backend/proxy/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
{
"main": "../dist/proxy.js",
"module": "../dist/proxy.mjs",
"types": "../dist/proxy.d.ts"
}
Loading