Closes #2440

Problem

withPageAuthRequired does not accept Next.js PageProps or LayoutProps types because AppRouterPageRoute expects AppRouterPageRouteOpts with loosely-typed params?: Promise<Record<string, string | string[]>>. Next.js typed routes produce narrower types (e.g. Promise<{ id: string }>) that are incompatible.

// TS error: Types of parameters 'props' and 'obj' are incompatible
export default auth0.withPageAuthRequired(
  async function Page(props: PageProps<"/customers/[id]/details">) {
    const { id } = await props.params;
    return <div>{id}</div>;
  }
);

Fix

Make AppRouterPageRoute, WithPageAuthRequiredAppRouter, and appRouteHandlerFactory generic over the props type P extends AppRouterPageRouteOpts. TypeScript infers P from the handler function, so the return type preserves the exact props type.

// Now works — props.params correctly typed as Promise<{ id: string }>
export default auth0.withPageAuthRequired(
  async function Page(props: PageProps<"/customers/[id]/details">) {
    const { id } = await props.params;
    return <div>{id}</div>;
  }
);

Also works with LayoutProps:

export default auth0.withPageAuthRequired(
  async function Layout(props: LayoutProps<"/dashboard">) {
    return <div>{props.children}</div>;
  }
);

Changes

• src/server/helpers/with-page-auth-required.ts:
  • AppRouterPageRoute<P> — generic with default AppRouterPageRouteOpts
  • WithPageAuthRequiredAppRouter — generic, infers P from handler
  • appRouteHandlerFactory — propagates generic through implementation

Testing

• All 819 existing tests pass
• TypeScript compiles without errors
• Backward compatible: existing code without generics continues to work (default type parameter)