Merge branch 'main' into frederikprijck-patch-1

Author: frederikprijck

.version

@@ -1 +1 @@
-v4.0.3
+v4.1.0

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Change Log
 
+## [v4.1.0](https://github.com/auth0/nextjs-auth0/tree/v4.1.0) (2025-03-13)
+[Full Changelog](https://github.com/auth0/nextjs-auth0/compare/v4.0.3...v4.1.0)
+
+**Added**
+- Programmatic PAR [\#1946](https://github.com/auth0/nextjs-auth0/pull/1946) ([tusharpandey13](https://github.com/tusharpandey13))
+
+**Fixed**
+- fix: stop importing named export from package.json [\#1962](https://github.com/auth0/nextjs-auth0/pull/1962) ([tusharpandey13](https://github.com/tusharpandey13))
+
 ## [v4.0.3](https://github.com/auth0/nextjs-auth0/tree/v4.0.3) (2025-03-10)
 [Full Changelog](https://github.com/auth0/nextjs-auth0/compare/v4.0.2...v4.0.3)
 

EXAMPLES.md

@@ -752,3 +752,33 @@ const sessionCookieValue = await generateSessionCookie(
   }
 )
 ```
+
+
+## Programmatic Pushed Authentication Requests (PAR)
+
+The method `startInteractiveLogin` can be called with authorizationParams to initiate an interactive login flow.  
+The code collects authorization parameters on the server side rather than constructing them directly in the browser.
+
+```typescript
+// app/api/auth/login/route.ts
+import { auth0 } from "./lib/auth0";
+import { NextRequest } from "next/server";
+
+export const GET = async (req: NextRequest) => {
+  // Extract custom parameters from request URL if needed
+  const searchParams = Object.fromEntries(req.nextUrl.searchParams.entries());
+
+  // Call startInteractiveLogin with optional parameters
+  return auth0.startInteractiveLogin({
+    // a custom returnTo URL can be specified
+    returnTo: "/dashboard",
+    authorizationParameters: {
+      prompt: searchParams.prompt,
+      login_hint: searchParams.login_hint,
+      // Add any custom auth parameters if required
+      audience: "custom-audience"
+    }
+  });
+};
+
+```