Function getTokens

Example: Server Component

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

export default async function Home() {
  const tokens = await getTokens();

  return <div>Expired: {tokens.isExpired.toString()}</div>;
}
Copy

Example: Server Action

"use server";

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

export async function getExpiredAction() {
  const tokens = await getTokens();

  return { expired: tokens.isExpired };
}
Copy

Example: API Handler

import { getTokens } from "@monocloud/auth-nextjs";
import { NextResponse } from "next/server";

export const GET = async () => {
  const tokens = await getTokens();

  return NextResponse.json({ expired: tokens.isExpired });
};
Copy

Example: Middleware

import { getTokens } from "@monocloud/auth-nextjs";
import { NextResponse } from "next/server";

export default async function proxy() {
  const tokens = await getTokens();

  if (tokens.isExpired) {
    return new NextResponse("Tokens expired", { status: 401 });
  }

  return NextResponse.next();
}
Copy

Example: Refresh the default token

The default token is the access token associated with your default authorization parameters:

• Scopes: MONOCLOUD_AUTH_SCOPES or options.defaultAuthParams.scopes
• Resource: MONOCLOUD_AUTH_RESOURCE or options.defaultAuthParams.resource

Calling getTokens() returns the current token set and refreshes the default token automatically when needed (for example, if it has expired). To force a refresh even when it isn’t expired, use forceRefresh: true.

import { getTokens } from "@monocloud/auth-nextjs";
import { NextResponse } from "next/server";

export const GET = async () => {
  // Forces a refresh of the default token
  const tokens = await getTokens({ forceRefresh: true });

  return NextResponse.json({ accessToken: tokens?.accessToken });
};
Copy

Example: Request an access token for resource(s)

Use resource and scopes to request an access token for one or more resources.

The requested resource and scopes must be included in the initial authorization flow (so the user has consented / the session is eligible to mint that token).

import { getTokens } from "@monocloud/auth-nextjs";
import { NextResponse } from "next/server";

export const GET = async () => {
  const tokens = await getTokens({
    resource: "https://first.example.com https://second.example.com",
    scopes: "read:first read:second shared",
  });

  return NextResponse.json({ accessToken: tokens?.accessToken });
};
Copy

Example: Middleware (Request)

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

export default async function proxy(req: NextRequest) {
  const tokens = await getTokens(req);

  if (tokens.isExpired) {
    return new NextResponse("Tokens expired", { status: 401 });
  }

  return NextResponse.next();
}
Copy

Example: API Handler (Request)

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

export const GET = async (req: NextRequest) => {
  const tokens = await getTokens(req);

  return NextResponse.json({ expired: tokens?.isExpired });
};
Copy

Example: Middleware (Response)

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

export default async function proxy(req: NextRequest) {
  const res = NextResponse.next();

  const tokens = await getTokens(req, res);

  res.headers.set("x-tokens-expired", tokens.isExpired.toString());

  return res;
}
Copy

Example: API Handler (Response)

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

export const GET = async (req: NextRequest) => {
  const res = new NextResponse("Custom Body");

  const tokens = await getTokens(req, res);

  if (!tokens.isExpired) {
    res.headers.set("x-auth-status", "active");
  }

  return res;
};
Copy

Example: Pages Router (Pages)

import { getTokens, MonoCloudTokens } from "@monocloud/auth-nextjs";
import { GetServerSideProps } from "next";

type Props = {
  tokens: MonoCloudTokens;
};

export default function Home({ tokens }: Props) {
  return <pre>Tokens: {JSON.stringify(tokens, null, 2)}</pre>;
}

export const getServerSideProps: GetServerSideProps<Props> = async (ctx) => {
  const tokens = await getTokens(ctx.req, ctx.res);

  return {
    props: {
      tokens: tokens
    }
  };
};
Copy

Example: Pages Router (API)

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

export default async function handler(
  req: NextApiRequest,
  res: NextApiResponse
) {
  const tokens = await getTokens(req, res);

  res.status(200).json({ accessToken: tokens?.accessToken });
}
Copy