import type { FastifyInstance } from 'fastify'; import { eq } from 'drizzle-orm'; import { getDb, schema } from '../db/index.js'; import { hashPassword, verifyPassword, signJwt } from '../utils/auth.js'; import { generateSnowflake } from '../utils/snowflake.js'; import { config } from '../config.js'; import type { RegisterRequest, LoginRequest, AuthResponse } from '@backspace/shared'; import { AVATAR_COLORS } from '@backspace/shared'; import { sanitizeUser } from '../utils/sanitize.js'; import { findFederatedUser } from './federation.js'; export async function authRoutes(app: FastifyInstance): Promise { app.post<{ Body: RegisterRequest }>('/api/auth/register', { config: { rateLimit: { max: 10, timeWindow: '2 minutes', keyGenerator: (request: any) => request.ip, }, }, }, async (request, reply) => { const { username, password, displayName, avatarColor: requestedAvatarColor, homeInstance, homeUserId } = request.body; if (!username || typeof username !== 'string') { return reply.code(400).send({ error: 'Username is required', statusCode: 400 }); } if (!password || typeof password !== 'string') { return reply.code(400).send({ error: 'Password is required', statusCode: 400 }); } const trimmedUsername = username.trim().toLowerCase(); // Replicated registrations (homeInstance provided) may use username@domain format // for collision fallback. Local registrations use strict alphanumeric+underscore. if (homeInstance) { // Validate homeInstance is a reasonable domain string if (typeof homeInstance !== 'string' || homeInstance.length > 253 || !/^[a-zA-Z0-9._-]+$/.test(homeInstance)) { return reply.code(400).send({ error: 'Invalid homeInstance domain', statusCode: 400 }); } if (trimmedUsername.includes('@')) { // username@domain format: validate local part + domain part const atIndex = trimmedUsername.indexOf('@'); const localPart = trimmedUsername.slice(0, atIndex); const domainPart = trimmedUsername.slice(atIndex + 1); if (localPart.length < 3 || localPart.length > 32 || !/^[a-z0-9_]+$/.test(localPart)) { return reply.code(400).send({ error: 'Username local part must be 3-32 lowercase alphanumeric/underscore characters', statusCode: 400 }); } if (domainPart.length === 0 || domainPart.length > 253 || !/^[a-zA-Z0-9._-]+$/.test(domainPart)) { return reply.code(400).send({ error: 'Username domain part is invalid', statusCode: 400 }); } if (trimmedUsername.length > 100) { return reply.code(400).send({ error: 'Username must be 100 characters or less', statusCode: 400 }); } } else { // Replicated users MUST use username@domain format — plain usernames // are reserved exclusively for native users of this instance return reply.code(400).send({ error: 'Replicated users must use username@domain format', statusCode: 400 }); } } else { // Local registration — strict validation if (trimmedUsername.length < 3 || trimmedUsername.length > 32) { return reply.code(400).send({ error: 'Username must be between 3 and 32 characters', statusCode: 400 }); } if (!/^[a-z0-9_]+$/.test(trimmedUsername)) { return reply.code(400).send({ error: 'Username can only contain lowercase letters, numbers, and underscores', statusCode: 400 }); } } if (password.length < 8) { return reply.code(400).send({ error: 'Password must be at least 8 characters', statusCode: 400 }); } const db = getDb(); // Check registration: DB setting overrides env var if explicitly set by admin const instanceRow = db.select().from(schema.instanceSettings).where(eq(schema.instanceSettings.id, 1)).get(); const registrationOpen = instanceRow?.registrationOpen !== null && instanceRow?.registrationOpen !== undefined ? instanceRow.registrationOpen === 1 : config.registrationOpen; if (!registrationOpen) { return reply.code(403).send({ error: 'Registration is currently closed', statusCode: 403 }); } const passwordHash = await hashPassword(password); // --- Federated stub upgrade path (BEFORE username uniqueness check) --- // If this is a federated registration, check if a relay-created stub already // exists for this person. If so, upgrade it (add credentials, update username) // instead of creating a duplicate record. The user gets their full DM history. // This must run BEFORE the username check because the stub may have a different // username (e.g., "291255103060533248@nova.ddns.net") that wouldn't collide. if (homeInstance && homeUserId) { const usernameBase = trimmedUsername.includes('@') ? trimmedUsername.split('@')[0]! : trimmedUsername; const existingStub = findFederatedUser(homeUserId, homeInstance, db, { username: usernameBase }); if (existingStub) { // If the found user already has real credentials, they already registered. // Return 409 so the client falls back to login. if (existingStub.passwordHash !== '!federation-replicated') { return reply.code(409).send({ error: 'Username already taken', statusCode: 409 }); } // Check the NEW username isn't taken by someone else (not the stub itself) const usernameCollision = db.select().from(schema.users) .where(eq(schema.users.username, trimmedUsername)).get(); if (usernameCollision && usernameCollision.id !== existingStub.id) { return reply.code(409).send({ error: 'Username already taken', statusCode: 409 }); } // Upgrade the stub: add credentials, update username and profile const updates: Record = { passwordHash, username: trimmedUsername, homeUserId, }; if (displayName?.trim() && !existingStub.displayName) { updates.displayName = displayName.trim(); } const avatarColor = (requestedAvatarColor && (AVATAR_COLORS as readonly string[]).includes(requestedAvatarColor)) ? requestedAvatarColor : AVATAR_COLORS[Math.floor(Math.random() * AVATAR_COLORS.length)]!; if (!existingStub.avatarColor) { updates.avatarColor = avatarColor; } db.update(schema.users) .set(updates) .where(eq(schema.users.id, existingStub.id)) .run(); const upgraded = db.select().from(schema.users).where(eq(schema.users.id, existingStub.id)).get(); if (!upgraded) { return reply.code(500).send({ error: 'Failed to upgrade user stub', statusCode: 500 }); } console.log(`[auth] Upgraded federation stub ${existingStub.id} (${existingStub.username} → ${trimmedUsername}) to full account`); const token = signJwt({ userId: upgraded.id, username: upgraded.username }); const response: AuthResponse = { token, user: sanitizeUser(upgraded, true), }; return reply.code(200).send(response); } } // --- Normal registration path (no existing stub found) --- // Username uniqueness check (for non-federated registrations, or federated // registrations where no stub was found to upgrade) const existing = db.select().from(schema.users).where(eq(schema.users.username, trimmedUsername)).get(); if (existing) { return reply.code(409).send({ error: 'Username already taken', statusCode: 409 }); } const userId = generateSnowflake(); const now = Date.now(); // First registered user becomes instance admin (replicated users are never admins) const userCount = db.select().from(schema.users).all().length; const isFirstUser = userCount === 0 && !homeInstance; const avatarColor = (requestedAvatarColor && (AVATAR_COLORS as readonly string[]).includes(requestedAvatarColor)) ? requestedAvatarColor : AVATAR_COLORS[Math.floor(Math.random() * AVATAR_COLORS.length)]; // Note: status is left at the schema default ('offline') and is set to // 'online' exclusively by the WebSocket auth path (ws/handler.ts). A // successful REST /register does not by itself imply a live connection — // the client may never establish a WS (transient network failure, mobile // background, error path between this 201 response and /ws connect), // which would otherwise produce a permanently stuck-online row that no // disconnect timer can clean up. The WS handshake will flip it to // 'online' once a real socket attaches. db.insert(schema.users).values({ id: userId, username: trimmedUsername, displayName: displayName?.trim() || null, passwordHash, isAdmin: isFirstUser ? 1 : 0, homeInstance: homeInstance || null, homeUserId: (homeInstance && homeUserId && typeof homeUserId === 'string') ? homeUserId : null, avatarColor, createdAt: now, }).run(); const user = db.select().from(schema.users).where(eq(schema.users.id, userId)).get(); if (!user) { return reply.code(500).send({ error: 'Failed to create user', statusCode: 500 }); } const token = signJwt({ userId: user.id, username: user.username }); const response: AuthResponse = { token, user: sanitizeUser(user, true), }; return reply.code(201).send(response); }); app.get<{ Querystring: { username?: string } }>('/api/auth/check-username', { config: { rateLimit: { max: 30, timeWindow: '1 minute', keyGenerator: (request: any) => request.ip, }, }, }, async (request, reply) => { const raw = request.query.username; if (!raw || typeof raw !== 'string') { return reply.code(400).send({ available: false, reason: 'Username is required' }); } const trimmed = raw.trim().toLowerCase(); // Format validation (same rules as registration) if (trimmed.length < 3 || trimmed.length > 32) { return reply.code(200).send({ available: false, reason: 'Username must be between 3 and 32 characters' }); } if (!/^[a-z0-9_]+$/.test(trimmed)) { return reply.code(200).send({ available: false, reason: 'Username can only contain lowercase letters, numbers, and underscores' }); } // Check registration is open const db = getDb(); const instanceRow = db.select().from(schema.instanceSettings).where(eq(schema.instanceSettings.id, 1)).get(); const registrationOpen = instanceRow?.registrationOpen !== null && instanceRow?.registrationOpen !== undefined ? instanceRow.registrationOpen === 1 : config.registrationOpen; if (!registrationOpen) { return reply.code(403).send({ available: false, reason: 'Registration is currently closed' }); } const existing = db.select().from(schema.users).where(eq(schema.users.username, trimmed)).get(); return reply.code(200).send({ available: !existing }); }); app.post<{ Body: LoginRequest }>('/api/auth/login', { config: { rateLimit: { max: 15, timeWindow: '2 minutes', keyGenerator: (request: any) => request.ip, }, }, }, async (request, reply) => { const { username, password } = request.body; if (!username || typeof username !== 'string') { return reply.code(400).send({ error: 'Username is required', statusCode: 400 }); } if (!password || typeof password !== 'string') { return reply.code(400).send({ error: 'Password is required', statusCode: 400 }); } const db = getDb(); const user = db.select().from(schema.users).where(eq(schema.users.username, username.trim().toLowerCase())).get(); if (!user) { return reply.code(401).send({ error: 'Invalid username or password', statusCode: 401 }); } if (user.isDeleted) { return reply.code(401).send({ error: 'This account has been deleted', statusCode: 401 }); } const validPassword = await verifyPassword(password, user.passwordHash); if (!validPassword) { // For federated users, try verifying against the home instance. // If the password is valid there but stale here, self-heal the local hash. if (user.homeInstance) { try { const homeUsername = user.username.includes('@') ? user.username.split('@')[0]! : user.username; const controller = new AbortController(); const timeout = setTimeout(() => controller.abort(), 10_000); const homeResponse = await fetch(`https://${user.homeInstance}/api/auth/login`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ username: homeUsername, password }), signal: controller.signal, }); clearTimeout(timeout); if (homeResponse.ok) { // Home instance accepted the password — update our stale hash. // Do NOT set passwordChangedAt: this is a state correction, not a // password change. Setting it would invalidate existing valid JWTs. const newHash = await hashPassword(password); db.update(schema.users) .set({ passwordHash: newHash }) .where(eq(schema.users.id, user.id)) .run(); app.log.info(`Self-healed password hash for federated user ${user.username} via ${user.homeInstance}`); } else { // Home instance also rejected — password is genuinely wrong return reply.code(401).send({ error: 'Invalid username or password', statusCode: 401 }); } } catch { // Home instance unreachable — fall back to local-only rejection return reply.code(401).send({ error: 'Invalid username or password', statusCode: 401 }); } } else { return reply.code(401).send({ error: 'Invalid username or password', statusCode: 401 }); } } // Note: status='online' is set exclusively by the WebSocket auth path // (ws/handler.ts). A successful REST /login does not by itself imply a // live connection — the client may never establish a WS (transient // network failure, mobile background, error path), which would otherwise // produce a permanently stuck-online row that no disconnect timer can // clean up. The user's reported status remains whatever it was; the WS // handshake will flip it to 'online' once a real socket attaches. const token = signJwt({ userId: user.id, username: user.username }); const response: AuthResponse = { token, user: sanitizeUser(user, true), }; return reply.code(200).send(response); }); }