bugfix: Remove React dependency from server helpers to fix edge runtime bundling

[tusharpandey13]

Fixes React import dependency in server-side helpers that caused bundling errors in Next.js middleware and edge runtime environments.

• All new/changed/fixed functionality is covered by tests (or N/A)
• I have added documentation for all new/changed functionality (or N/A)

🔍 RCA

The import type React from "react" statement in with-page-auth-required.ts created a transitive dependency that caused Next.js bundler to include React references in edge runtime contexts where React is not available.
This affected ANY import from @auth0/nextjs-auth0/server due to module export bundling, not just direct usage of withPageAuthRequired.

📋 Changes

Changes AppRouterPageRoute return type from Promise<React.JSX.Element> to Promise<unknown> to maintain type safety without requiring React.

• Changed src/server/helpers/with-page-auth-required.ts: Remove React import and change AppRouterPageRoute return type to Promise<unknown>
• Changed src/server/helpers/with-page-auth-required.test.ts: Add type assertion for test compatibility with ReactDOMServer

📎 References

Fixes: #2328

🎯 Testing

Automated:

• All existing 340 unit tests pass with the type safety improvements
• Added type assertion in test file to maintain ReactDOMServer compatibility

Manual:

1. Import Auth0Client from @auth0/nextjs-auth0/server in Next.js middleware
2. Verify no "React is not defined" errors occur during build or runtime
3. Confirm withPageAuthRequired still works with App Router pages
4. Test in Next.js 14.2+ with Pages Router configuration
5. Verify compiled output contains no React references in dist/server/ files

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 86.90%. Comparing base (76e635d) to head (b201a20).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #2329   +/-   ##
=======================================
  Coverage   86.90%   86.90%           
=======================================
  Files          37       37           
  Lines        4070     4070           
  Branches      799      799           
=======================================
  Hits         3537     3537           
  Misses        530      530           
  Partials        3        3           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[tusharpandey13]

@claude

[github-actions]

Claude finished @tusharpandey13's task —— View job

---

Code Review Complete ✅

• Read PR diff and understand changes
• Review project context and architecture
• Create pending review
• Analyze changes for potential issues
• Submit comprehensive review

Summary: This PR effectively solves the edge runtime bundling issue by removing the React import dependency from server helpers. The changes are minimal, focused, and maintain type safety while eliminating the problematic React reference. The solution is appropriate and ready for merge.

---

[github-actions]

Overall Assessment

✅ This pull request is ready to be merged

The changes effectively solve the edge runtime bundling issue by removing the React import dependency from server helpers. The type safety is maintained while eliminating the problematic React reference that caused bundling errors in Next.js middleware and edge runtime contexts.

Key points:

• Clean removal of React import without compromising functionality
• Appropriate use of unknown type maintains type safety while avoiding React dependency
• Test updates correctly handle the type assertion
• All existing tests pass, indicating no regressions

[tusharpandey13]

@claude please review this PR

[github-actions]

Claude finished @tusharpandey13's task —— View job

---

PR Review Complete ✅

• Read PR diff and understand changes
• Review project context and architecture
• Perform code quality review
• Perform security review
• Perform performance review
• Submit comprehensive review

---

Overall Assessment

✅ This PR effectively resolves the edge runtime bundling issue by eliminating the React import dependency from server helpers. The type change from Promise<React.JSX.Element> to Promise<unknown> maintains type safety while removing the problematic transitive dependency. All tests pass, coverage is maintained, and the implementation correctly preserves functionality while solving the root cause described in issue #2328.

---

View job