Authentication Overview

import { client } from '@/lib/auth'

// Sign up with email and password
const { data, error } = await client.signUp.email({
  email: 'user@example.com',
  password: 'securePassword123',
  name: 'John Doe'
})

// Sign in
const { data, error } = await client.signIn.email({
  email: 'user@example.com',
  password: 'securePassword123'
})

import { client } from '@/lib/auth'

// Send OTP to email
await client.emailOtp.sendVerificationOtp({
  email: 'user@example.com',
  type: 'sign-in' // or 'email-verification' or 'forget-password'
})

// Verify OTP and sign in
const { data, error } = await client.emailOtp.verifyEmail({
  email: 'user@example.com',
  otp: '123456'
})

import { client } from '@/lib/auth'

// Initiate OAuth flow
await client.signIn.social({
  provider: 'google', // or 'github', 'microsoft', 'facebook'
  callbackURL: '/dashboard'
})

// Client-side
import { useSession } from '@/lib/auth'

function MyComponent() {
  const { data: session, isPending } = useSession()
  
  if (isPending) return <div>Loading...</div>
  if (!session) return <div>Not authenticated</div>
  
  return <div>Hello, {session.user.name}!</div>
}

// Server-side (Server Components or API Routes)
import { auth } from '@/lib/auth'
import { headers } from 'next/headers'

const session = await auth.api.getSession({
  headers: await headers()
})

if (!session) {
  // User is not authenticated
}

import { client } from '@/lib/auth'

// Create an organization
const { data } = await client.organization.create({
  name: 'My Company',
  slug: 'my-company'
})

// Invite members
await client.organization.inviteMember({
  organizationId: 'org_123',
  email: 'member@example.com',
  role: 'member' // or 'admin'
})

emailVerification: {
  autoSignInAfterVerification: true,
  afterEmailVerification: async (user) => {
    // Send welcome email after successful verification
  }
}

emailAndPassword: {
  enabled: true,
  requireEmailVerification: isEmailVerificationEnabled,
  sendResetPassword: async ({ user, url }) => {
    // Send password reset email
  }
}

import { client } from '@/lib/auth'

// Request password reset
await client.forgetPassword({
  email: 'user@example.com',
  redirectTo: '/reset-password'
})

// Reset with token
await client.resetPassword({
  newPassword: 'newSecurePassword123',
  token: 'reset_token_from_email'
})

import { signOut } from '@/lib/auth'

// Sign out current session
await signOut()

// Sign out and redirect
await signOut({ redirect: '/login' })

pages: {
  signIn: '/login',
  signUp: '/register',
  error: '/error',
  verify: '/verify'
}