Overview
Authentication server actions handle user registration, session management, and profile updates in VizBoard.
SignUp
Creates a new user account with email and password authentication.
export async function SignUp(data: signup): Promise<SignUpResponse>
Parameters
User registration dataUser’s email address (will be converted to lowercase)
User’s password (will be hashed with bcrypt)
Response
Indicates if the registration was successful
Success or error messagePossible messages:
"User registered successfully" - Registration succeeded"This email is already registered." - Email already exists"This email is already registered with Google or GitHub..." - OAuth conflict
Example
import { SignUp } from '@/app/actions/auth/signUp'
const result = await SignUp({
email: '[email protected]',
password: 'securePassword123',
firstName: 'John',
lastName: 'Doe'
})
if (result.success) {
console.log('User registered successfully')
} else {
console.error(result.message)
}
getUserByEmail
Retrieves a user by their email address.
export async function getUserByEmail(email: string): Promise<User | null>
Parameters
The email address to search for
Response
Returns a User object if found, or null if no user exists with that email.
Hashed password (null for OAuth users)
Example
import { getUserByEmail } from '@/app/actions/user/user'
const user = await getUserByEmail('[email protected]')
if (user) {
console.log(`Found user: ${user.firstName} ${user.lastName}`)
}
getUserBySession
Retrieves the currently authenticated user from the session.
export async function getUserBySession(): Promise<UserSessionResponse>
Response
Indicates if the user was retrieved successfully
The authenticated user object (only present when success is true)
Error message (only present when success is false)Possible values:
"Not authenticated" - No active session"Error fetching user" - Database error
Example
import { getUserBySession } from '@/app/actions/user/user'
const result = await getUserBySession()
if (result.success && result.user) {
console.log(`Current user: ${result.user.name}`)
} else {
console.error(result.message)
}
updateUserName
Updates the user’s first and last name.
export async function updateUserName(
userId: string,
data: { firstName: string; lastName: string }
): Promise<UpdateResponse>
Parameters
The ID of the user to update
Response
Indicates if the update was successful
Example
import { updateUserName } from '@/app/actions/user/user'
const result = await updateUserName('clx1234567', {
firstName: 'Jane',
lastName: 'Smith'
})
if (result.success) {
console.log('Name updated successfully')
}
This action automatically revalidates the /settings path.
updateUserEmail
Updates the user’s email address.
export async function updateUserEmail(
userId: string,
data: { email: string }
): Promise<UpdateResponse>
Parameters
The ID of the user to update
New email address (will be converted to lowercase)
Response
Indicates if the update was successful
Example
import { updateUserEmail } from '@/app/actions/user/user'
const result = await updateUserEmail('clx1234567', {
email: '[email protected]'
})
updateUserPassword
Updates the user’s password after verifying the current password.
export async function updateUserPassword(
userId: string,
userPassword: string | null,
data: { currentPassword: string; newPassword: string }
): Promise<UpdateResponse>
Parameters
The ID of the user to update
The user’s current hashed password (null for OAuth users)
User’s current password (plaintext)
New password (plaintext, will be hashed)
Response
Indicates if the update was successful
Success or error messagePossible messages:
"Password updated successfully""You are connected with a social account""Current password is not correct""New password must be different from current password"
Example
import { updateUserPassword } from '@/app/actions/user/user'
const result = await updateUserPassword(
'clx1234567',
user.password, // current hashed password from DB
{
currentPassword: 'oldPassword123',
newPassword: 'newSecurePassword456'
}
)
if (result.success) {
console.log('Password updated')
} else {
console.error(result.message)
}
deleteUserAccount
Permanently deletes a user account and clears their session.
export async function deleteUserAccount(userId: string): Promise<DeleteResponse>
Parameters
The ID of the user to delete
Response
Indicates if the deletion was successful
Example
import { deleteUserAccount } from '@/app/actions/user/user'
const result = await deleteUserAccount('clx1234567')
if (result.success) {
// Redirect to landing page
redirect('/')
}
This action is irreversible and will delete all user data, including projects, connections, and widgets.
Type Definitions
interface signup {
firstName: string
lastName: string
email: string
password: string
}
interface SignUpResponse {
success: boolean
message: string
}
interface UserSessionResponse {
success: boolean
user?: User
message?: string
}
interface UpdateResponse {
success: boolean
message: string
}
interface DeleteResponse {
success: boolean
message: string
}
