Server Helpers — getSession() & currentUser()

Overview

Server helpers let you access the authenticated user in server components and API routes. Two levels are available:

• getSession() — fast JWT verification, no network call
• currentUser() — full user profile via API call

Setup

import { createHostedServerHelpers } from "@vibelogin/nextjs/hosted-server";

const { getSession, currentUser } = createHostedServerHelpers({
  projectId: process.env.VIBELOGIN_PROJECT_ID!,
});

getSession()

Returns the JWT payload without making any network calls. Available with Tier 1 (minimal) setup.

// app/dashboard/page.tsx
export default async function Dashboard() {
  const session = await getSession();
  if (!session) redirect("/");

  return <p>User ID: {session.userId}, Role: {session.role}</p>;
}

Return type HostedSessionIdentity

currentUser()

Returns the full user profile by calling the local auth proxy. Requires Tier 2 setup (hosted handler).

export default async function ProfilePage() {
  const user = await currentUser();
  if (!user) redirect("/");

  return (
    <div>
      <h1>{user.name}</h1>
      <p>{user.email}</p>
      <p>Verified: {user.emailVerified ? "Yes" : "No"}</p>
    </div>
  );
}

Return type HostedSessionUser

When to use which

Configuration reference