Function monoCloudAuth

monoCloudAuth(options?: MonoCloudAuthOptions): MonoCloudAuthHandler

Creates a Next.js catch-all auth route handler (Pages Router and App Router) for the built-in routes (/signin, /callback, /userinfo, /signout).

Mount this handler on a catch-all route (e.g. /api/auth/[...monocloud]).

If you already use authMiddleware(), you typically don’t need this handler. Use monoCloudAuth() when middleware cannot be used or when auth routes need customization.

Parameters

Optionaloptions: MonoCloudAuthOptions
Optional configuration for the auth handler.

Returns MonoCloudAuthHandler

Returns a Next.js-compatible handler for App Router route handlers or Pages Router API routes.

Example: App Router

import { monoCloudAuth } from "@monocloud/auth-nextjs";

export const GET = monoCloudAuth();

Example: App Router (Response)

import { monoCloudAuth } from "@monocloud/auth-nextjs";
import { NextRequest, NextResponse } from "next/server";

export const GET = (req: NextRequest) => {
  const authHandler = monoCloudAuth();

  const res = new NextResponse();

  res.cookies.set("last_auth_requested", `${Date.now()}`);

  return authHandler(req, res);
};

Example: Pages Router

import { monoCloudAuth } from "@monocloud/auth-nextjs";

export default monoCloudAuth();

Example: Pages Router (Response)

import { monoCloudAuth } from "@monocloud/auth-nextjs";
import { NextApiRequest, NextApiResponse } from "next";

export default function handler(req: NextApiRequest, res: NextApiResponse) {
  const authHandler = monoCloudAuth();

  res.setHeader("last_auth_requested", `${Date.now()}`);

  return authHandler(req, res);
}