Type conflicts between NextAuth and Next.js Route Handlers

[Lada496]

Question 💬

I'm having type errors while trying to implement Advanced initialization with Route Handlers[https://nextjs.org/docs/app/building-your-application/routing/route-handlers] and wondering if there is any solution to fix this issue.

Error Messages:

• Type '{ __tag__: "GET"; __param_position__: "first"; __param_type__: NextApiRequest; }' does not satisfy the constraint 'ParamCheck<Request | NextRequest>'.
• Type '{ __tag__: "POST"; __param_position__: "first"; __param_type__: NextApiRequest; }' does not satisfy the constraint 'ParamCheck<Request | NextRequest>'.
• Types of property '__param_type__' are incompatible.
• Type 'NextApiRequest' is not assignable to type 'Request | NextRequest'.
• Type 'NextApiRequest' is missing the following properties from type 'NextRequest': geo, ip, nextUrl, page, and 19 more.

Code

import type { NextApiRequest, NextApiResponse } from "next";
import { cookies } from "next/headers";
import NextAuth from "next-auth";
import { authOptions } from "~/server/auth";

async function auth(req: NextApiRequest, res: NextApiResponse) {
 ...some logic
  return await NextAuth(req, res, authOptions);
}

export { auth as GET, auth as POST };

In contrary when I use Request instead of NextApiRequest, then I get another type error: Type 'Request' is missing the following properties from type 'NextApiRequest': query, cookies, env, aborted, and 53 more.

How to reproduce ☕️

• Next.js v13.4.1
• NextAuth.js v4.21.0

While code is available here

Contributing 🙌🏽

Yes, I am willing to help answer this question in a PR

[balazsorban44]

App Router's Route Handlers are typed differently than the Pages Router. Check out https://nextjs.org/docs/app/api-reference/file-conventions/route

[Lada496]

I put a solution here just in case someone also faces the same problem as me.

import type { NextApiRequest, NextApiResponse } from "next";
import { cookies } from "next/headers";
import NextAuth from "next-auth";
import { authOptions } from "~/server/auth";

type CombineRequest = Request & NextApiRequest;
type CombineResponse = Response & NextApiResponse;

async function auth(req: CombineRequest, res: CombineResponse) {
 ...some logic
  return await NextAuth(req, res, authOptions);
}

export { auth as GET, auth as POST };

[balazsorban44]

The correct solution is:

import type { NextRequest } from "next/server"
import NextAuth from "next-auth"
import { authOptions } from "~/server/auth"

interface RouteHandlerContext {
  params: { nextauth: string[] }
}

async function auth(req: NextRequest, context: RouteHandlerContext) {
  // ...some logic
  return await NextAuth(req, context, authOptions)
}

export { auth as GET, auth as POST }

See the link I sent above: #8243 (comment)

[Lada496]

@balazsorban44 Thank you for your response. However TypeScript still complains with your solution asking me to use NextApiRequest instead of NextRequest.

Please correct me if I'm doing wrong, however, the followings are what I've found.
As long as I read the source code, NextAuth receives two different parameters: ...args: [AuthOptions] | [NextApiRequest, NextApiResponse, AuthOptions]. Therefore, NextRequest as a req type is not assignable from TypeScript perspective and I think we need to add some code at https://github.com/nextauthjs/next-auth/blob/main/packages/next-auth/src/next/index.ts to accept that types like this.

// Before
function NextAuth(options: AuthOptions): any
function NextAuth(
  req: NextApiRequest,
  res: NextApiResponse,
  options: AuthOptions
): any

/** The main entry point to next-auth */
function NextAuth(
  ...args: [AuthOptions] | [NextApiRequest, NextApiResponse, AuthOptions]
) {
  if (args.length === 1) {
    return async (
      req: NextAuthRequest | NextRequest,
      res: NextAuthResponse | RouteHandlerContext
    ) => {
      if ((res as unknown as any)?.params) {
        return await NextAuthRouteHandler(
          req as unknown as NextRequest,
          res as RouteHandlerContext,
          args[0]
        )
      }
      return await NextAuthApiHandler(
        req as NextApiRequest,
        res as NextApiResponse,
        args[0]
      )
    }
  }

  if ((args[1] as any)?.params) {
    return NextAuthRouteHandler(
      ...(args as unknown as Parameters<typeof NextAuthRouteHandler>)
    )
  }

  return NextAuthApiHandler(...args)
}

// After
function NextAuth(options: AuthOptions): any
function NextAuth(
  req: NextApiRequest,
  res: NextApiResponse,
  options: AuthOptions
): any
function NextAuth(
  req: NextRequest,
  res: RouteHandlerContext,
  options: AuthOptions
): any


/** The main entry point to next-auth */
function NextAuth(
  ...args: [AuthOptions] | [NextApiRequest, NextApiResponse , AuthOptions] | [NextRequest,RouteHandlerContext,AuthOptions]
) {
  if (args.length === 1) {
    return async (
      req: NextAuthRequest | NextRequest,
      res: NextAuthResponse | RouteHandlerContext
    ) => {
      if ((res as unknown as any)?.params) {
        return await NextAuthRouteHandler(
          req as unknown as NextRequest,
          res as RouteHandlerContext,
          args[0]
        )
      }
      return await NextAuthApiHandler(
        req as NextApiRequest,
        res as NextApiResponse,
        args[0]
      )
    }
  }

  if ((args[1] as any)?.params) {
    return NextAuthRouteHandler(
      ...(args as unknown as Parameters<typeof NextAuthRouteHandler>)
    )
  }

  return NextAuthApiHandler(...args as Parameters<typeof NextAuthApiHandler>)
}

export default NextAuth

Please take a look. Thanks.

[balazsorban44]

It's on the v4 branch

next-auth/packages/next-auth/src/next/index.ts

Lines 118 to 122 in 20c3fe3

	function NextAuth(
	req: NextRequest,
	res: RouteHandlerContext,
	options: AuthOptions
	): any

[Lada496]

@balazsorban44 Thank you for your help.
I needed to update the next-auth version and now everything works fine.
I really appreciate it!

[goerlitz]

The correct solution is:

import type { NextRequest } from "next/server"
import NextAuth from "next-auth"
import { authOptions } from "~/server/auth"

interface RouteHandlerContext {
  params: { nextauth: string[] }
}

async function auth(req: NextRequest, context: RouteHandlerContext) {
  // ...some logic
  return await NextAuth(req, context, authOptions)
}

export { auth as GET, auth as POST }

See the link I sent above: #8243 (comment)

Although next-auth is a great library, It took me 3 days to figure out how to do the advanced initialization with Route Handler correctly. After a lot of trial and error and digging deep into the source code of next-auth I finally came up with something that looks closely like @balazsorban44's solution. Unfortunately, only afterwards I found this discussion. :(

👉 I would strongly suggest to update the documentation with this example for Route Handler.

What I found most confusing:

1. The signature of Next's RouteHandler is different from what the NextAuth RouteHandler expects

export type RouteHandler = (
  req: BaseNextRequest,
  res: BaseNextResponse,
  parsedUrl: NextUrlWithParsedQuery
) => PromiseLike<boolean> | boolean

async function auth(req: NextRequest, context: RouteHandlerContext) {
  // ...some logic
  return await NextAuth(req, context, authOptions)
}

2. RouteHandlerContext is not exported from the library
3. https://nextjs.org/docs/app/api-reference/file-conventions/route is really helpful in understanding what is going on, but it is not referenced from https://next-auth.js.org/configuration/initialization#advanced-initialization

[Magimart]

I put a solution here just in case someone also faces the same problem as me.

import type { NextApiRequest, NextApiResponse } from "next";
import { cookies } from "next/headers";
import NextAuth from "next-auth";
import { authOptions } from "~/server/auth";

type CombineRequest = Request & NextApiRequest;
type CombineResponse = Response & NextApiResponse;

async function auth(req: CombineRequest, res: CombineResponse) {
 ...some logic
  return await NextAuth(req, res, authOptions);
}

export { auth as GET, auth as POST };

type CombineRequest = Request & NextApiRequest;
type CombineResponse = Response & NextApiResponse;
async function auth(req: CombineRequest, res: CombineResponse){ }
solved the problem with nextjs 13.5.4v and deployed on vercel Node 18x

this is as of now best solution for this issue. Most solutions that recommended like turning strict to false only works in development but not in build or production.

[lifeike]

one inconvenience I met, not urgent, however, hope someone could look at in the future.

when i use next-auth v5 in the middleware file, i have some code like this:

const {auth} = nextAuth(authConfig) export default auth((req)=>{//middleware logic})

in this case, the req's type passed into auth function is NextAuthRequest, basically something like this

export interface NextAuthRequest extends NextRequest { auth: Session | null }
added a auth property into NextRequest, however, this NextAuthRequest is not exported, which is not convenient when i want to pass this param to break down pieces of middleware.

[skdhatarwal]

@balazsorban44 with Nextjs 15.1.7 App router the suggested solution for advanced initialization
interface RouteHandlerContext { params: { nextauth: string[] }; } async function handler( req: NextRequest, context: RouteHandlerContext, ): Promise<void> { // Get auth options async const options = await authOptions(); return await NextAuth(req, context, options); } export { handler as GET, handler as POST };

I get error when building the app
app/api/auth/[...nextauth]/route.ts Type error: Route "app/api/auth/[...nextauth]/route.ts" has an invalid "GET" export: Type "RouteHandlerContext" is not a valid type for the function's second argument.
I would appreciate any help.

[djm158]

@balazsorban44 with Nextjs 15.1.7 App router the suggested solution for advanced initialization interface RouteHandlerContext { params: { nextauth: string[] }; } async function handler( req: NextRequest, context: RouteHandlerContext, ): Promise<void> { // Get auth options async const options = await authOptions(); return await NextAuth(req, context, options); } export { handler as GET, handler as POST };

I get error when building the app app/api/auth/[...nextauth]/route.ts Type error: Route "app/api/auth/[...nextauth]/route.ts" has an invalid "GET" export: Type "RouteHandlerContext" is not a valid type for the function's second argument. I would appreciate any help.

also dealing with this error, Next 15.2.3 app router