Merge branch 'main' into test/github-ci-migration

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Change Log
 
+## [v3.2.0](https://github.com/auth0/nextjs-auth0/tree/v3.2.0) (2023-10-05)
+[Full Changelog](https://github.com/auth0/nextjs-auth0/compare/v3.1.0...v3.2.0)
+
+**Added**
+- Add support for passing a custom http agent [\#1447](https://github.com/auth0/nextjs-auth0/pull/1447) ([ryanolson-aumni](https://github.com/ryanolson-aumni))
+- fix: add missing touchSession for exported function [\#1461](https://github.com/auth0/nextjs-auth0/pull/1461) ([benevbright](https://github.com/benevbright))
+
+**Fixed**
+- withApiAuthRequired callback can return just Response [\#1476](https://github.com/auth0/nextjs-auth0/pull/1476) ([adamjmcgrath](https://github.com/adamjmcgrath))
+
 ## [v3.1.0](https://github.com/auth0/nextjs-auth0/tree/v3.1.0) (2023-08-08)
 [Full Changelog](https://github.com/auth0/nextjs-auth0/compare/v3.0.1...v3.1.0)
 

CONTRIBUTING.md

@@ -12,7 +12,6 @@ Please read [Auth0's contribution guidelines](https://github.com/auth0/open-sour
 
 - `npm install`: install dependencies
 - `npm run build`: Build the binary
-- `npm run build:test`: Do this once to build the test harness for the tests
 - `npm test`: Run the unit tests
 - `npm run test:watch`: Run the unit tests and watch for changes
 - `npm run install:example`: Install the examples

EXAMPLES.md

@@ -251,7 +251,7 @@ Requests to `/api/protected` without a valid session cookie will fail with `401`
 // app/api/protected/route.js
 import { withApiAuthRequired, getSession } from '@auth0/nextjs-auth0';
 
-export default withApiAuthRequired(async function myApiRoute(req) {
+export const GET = withApiAuthRequired(async function myApiRoute(req) {
   const res = new NextResponse();
   const { user } = await getSession(req, res);
   return NextResponse.json({ protected: 'My Secret', id: user.sub }, res);

README.md

@@ -96,7 +96,7 @@ Add `handleAuth()` to your app, which creates the following route handlers under
 
 ##### Add the Dynamic API Route
 
-Create a [catch-all, dynamic API route handler](https://nextjs.org/docs/api-routes/dynamic-api-routes#optional-catch-all-api-routes) under the `/pages/api` directory:
+Create a [dynamic API route handler](https://nextjs.org/docs/pages/building-your-application/routing/api-routes#dynamic-api-routes) under the `/pages/api` directory:
 
 - Create an `auth` directory under the `/pages/api/` directory.
 - Create a `[auth0].js` file under the newly created `auth` directory.

docs/assets/style.css

@@ -32,7 +32,6 @@
     --light-color-ts-accessor: var(--light-color-ts-property);
     --light-color-ts-get-signature: var(--light-color-ts-accessor);
     --light-color-ts-set-signature: var(--light-color-ts-accessor);
-    /* object literal not included as it is not used and will be removed in 0.25 */
     --light-color-ts-type-alias: #d51270;
     /* reference not included as links will be colored with the kind that it points to */
 
@@ -72,7 +71,6 @@
     --dark-color-ts-accessor: var(--dark-color-ts-property);
     --dark-color-ts-get-signature: var(--dark-color-ts-accessor);
     --dark-color-ts-set-signature: var(--dark-color-ts-accessor);
-    /* object literal not included as it is not used and will be removed in 0.25 */
     --dark-color-ts-type-alias: #ff6492;
     /* reference not included as links will be colored with the kind that it points to */
 
@@ -468,13 +466,12 @@ blockquote {
     padding: 0 0 0 20px;
     margin: 0;
 }
-.tsd-typography h4,
 .tsd-typography .tsd-index-panel h3,
 .tsd-index-panel .tsd-typography h3,
+.tsd-typography h4,
 .tsd-typography h5,
 .tsd-typography h6 {
     font-size: 1em;
-    margin: 0;
 }
 .tsd-typography h5,
 .tsd-typography h6 {
@@ -485,6 +482,19 @@ blockquote {
 .tsd-typography ol {
     margin: 1em 0;
 }
+.tsd-typography table {
+    border-collapse: collapse;
+    border: none;
+}
+.tsd-typography td,
+.tsd-typography th {
+    padding: 6px 13px;
+    border: 1px solid var(--color-accent);
+}
+.tsd-typography thead,
+.tsd-typography tr:nth-child(even) {
+    background-color: var(--color-background-secondary);
+}
 
 .tsd-breadcrumb {
     margin: 0;
@@ -900,21 +910,25 @@ a.tsd-index-link {
     box-shadow: 0 0 4px rgba(0, 0, 0, 0.25);
 }
 #tsd-search .results li {
-    padding: 0 10px;
     background-color: var(--color-background);
+    line-height: initial;
+    padding: 4px;
 }
 #tsd-search .results li:nth-child(even) {
     background-color: var(--color-background-secondary);
 }
 #tsd-search .results li.state {
     display: none;
 }
-#tsd-search .results li.current,
-#tsd-search .results li:hover {
+#tsd-search .results li.current:not(.no-results),
+#tsd-search .results li:hover:not(.no-results) {
     background-color: var(--color-accent);
 }
 #tsd-search .results a {
-    display: block;
+    display: flex;
+    align-items: center;
+    padding: 0.25rem;
+    box-sizing: border-box;
 }
 #tsd-search .results a:before {
     top: 10px;
@@ -1070,7 +1084,9 @@ ul.tsd-type-parameter-list h5 {
     overflow: hidden;
     opacity: 0.8;
     height: 40px;
-    transition: opacity 0.1s, background-color 0.2s;
+    transition:
+        opacity 0.1s,
+        background-color 0.2s;
     vertical-align: bottom;
     cursor: pointer;
 }
@@ -1122,7 +1138,7 @@ img {
 }
 
 .deprecated {
-    text-decoration: line-through;
+    text-decoration: line-through !important;
 }
 
 .warning {