pr 1750 (#2158)

Co-authored-by: Alexander Hoekje List <atlex2@gmail.com>
Co-authored-by: Steven Wong <steven.wong@okta.com>
Co-authored-by: Desu Sai Venkat <48179357+desusai7@users.noreply.github.com>
Co-authored-by: Jonathon Klobucar <jonathon.klobucar@gmail.com>
Co-authored-by: Sambego <sambellen@gmail.com>
Co-authored-by: Frederik Prijck <frederik.prijck@okta.com>
Co-authored-by: Frederik Prijck <frederik.prijck@auth0.com>
Co-authored-by: arpit-jain_atko <arpit.jain@okta.com>
Co-authored-by: Arpit Jain <167312832+arpit-jn@users.noreply.github.com>
Co-authored-by: Filip Skokan <filip.skokan@okta.com>
Co-authored-by: simon-debruijn <simon.debruijn@hotmail.com>

Author: 10 people

src/helpers/with-page-auth-required.ts

@@ -136,9 +136,11 @@ export type WithPageAuthRequiredAppRouterOptions = {
  * // app/protected-page/page.js
  * import { withPageAuthRequired } from '@auth0/nextjs-auth0';
  *
- * export default function withPageAuthRequired(ProtectedPage() {
+ * const ProtectedPage = withPageAuthRequired(async function ProtectedPage() {
  *   return <div>Protected content</div>;
  * }, { returnTo: '/protected-page' });
+ *
+ * export default ProtectedPage;
  * ```
  *
  * If the user visits `/protected-page` without a valid session, it will redirect the user to the
@@ -153,15 +155,20 @@ export type WithPageAuthRequiredAppRouterOptions = {
  *
  * ```js
  * // app/protected-page/[slug]/page.js
- * import { withPageAuthRequired } from '@auth0/nextjs-auth0';
- *
- * export default function withPageAuthRequired(ProtectedPage() {
- *   return <div>Protected content</div>;
+ * import { AppRouterPageRouteOpts, withPageAuthRequired } from '@auth0/nextjs-auth0';
+ * 
+ * const ProtectedPage = withPageAuthRequired(async function ProtectedPage({
+ *   params, searchParams
+ * }: AppRouterPageRouteOpts) {
+ *   const slug = params?.slug as string;
+ *   return <div>Protected content for {slug}</div>;
  * }, {
  *   returnTo({ params }) {
- *     return `/protected-page/${params.slug}`
+ *     return `/protected-page/${params?.slug}`;
  *   }
  * });
+ * 
+ * export default ProtectedPage;
  * ```
  *
  * @category Server