import { randomBytes, timingSafeEqual } from 'crypto' import { getDatabase } from './db' import { hashPassword, verifyPassword } from './password' /** * Constant-time string comparison to prevent timing attacks. */ export function safeCompare(a: string, b: string): boolean { if (typeof a !== 'string' || typeof b !== 'string') return false const bufA = Buffer.from(a) const bufB = Buffer.from(b) if (bufA.length !== bufB.length) { // Compare against dummy buffer to avoid timing leak on length mismatch const dummy = Buffer.alloc(bufA.length) timingSafeEqual(bufA, dummy) return false } return timingSafeEqual(bufA, bufB) } export interface User { id: number username: string display_name: string role: 'admin' | 'operator' | 'viewer' workspace_id: number provider?: 'local' | 'google' email?: string | null avatar_url?: string | null is_approved?: number created_at: number updated_at: number last_login_at: number | null /** Agent name when request is made on behalf of a specific agent (via X-Agent-Name header) */ agent_name?: string | null } export interface UserSession { id: number token: string user_id: number workspace_id: number expires_at: number created_at: number ip_address: string | null user_agent: string | null } interface SessionQueryRow { id: number username: string display_name: string role: 'admin' | 'operator' | 'viewer' provider: 'local' | 'google' | null email: string | null avatar_url: string | null is_approved: number workspace_id: number created_at: number updated_at: number last_login_at: number | null session_id: number } interface UserQueryRow { id: number username: string display_name: string role: 'admin' | 'operator' | 'viewer' provider: 'local' | 'google' | null email: string | null avatar_url: string | null is_approved: number workspace_id: number created_at: number updated_at: number last_login_at: number | null password_hash: string } // Session management const SESSION_DURATION = 7 * 24 * 60 * 60 // 7 days in seconds function getDefaultWorkspaceId(): number { try { const db = getDatabase() const row = db.prepare(`SELECT id FROM workspaces WHERE slug = 'default' LIMIT 1`).get() as { id?: number } | undefined return row?.id || 1 } catch { return 1 } } export function getWorkspaceIdFromRequest(request: Request): number { const user = getUserFromRequest(request) return user?.workspace_id || getDefaultWorkspaceId() } export function createSession( userId: number, ipAddress?: string, userAgent?: string, workspaceId?: number ): { token: string; expiresAt: number } { const db = getDatabase() const token = randomBytes(32).toString('hex') const now = Math.floor(Date.now() / 1000) const expiresAt = now + SESSION_DURATION const resolvedWorkspaceId = workspaceId ?? ((db.prepare('SELECT workspace_id FROM users WHERE id = ?').get(userId) as { workspace_id?: number } | undefined)?.workspace_id || getDefaultWorkspaceId()) db.prepare(` INSERT INTO user_sessions (token, user_id, expires_at, ip_address, user_agent, workspace_id) VALUES (?, ?, ?, ?, ?, ?) `).run(token, userId, expiresAt, ipAddress || null, userAgent || null, resolvedWorkspaceId) // Update user's last login db.prepare('UPDATE users SET last_login_at = ?, updated_at = ? WHERE id = ?').run(now, now, userId) // Clean up expired sessions db.prepare('DELETE FROM user_sessions WHERE expires_at < ?').run(now) return { token, expiresAt } } export function validateSession(token: string): (User & { sessionId: number }) | null { if (!token) return null const db = getDatabase() const now = Math.floor(Date.now() / 1000) const row = db.prepare(` SELECT u.id, u.username, u.display_name, u.role, u.provider, u.email, u.avatar_url, u.is_approved, COALESCE(s.workspace_id, u.workspace_id, 1) as workspace_id, u.created_at, u.updated_at, u.last_login_at, s.id as session_id FROM user_sessions s JOIN users u ON u.id = s.user_id WHERE s.token = ? AND s.expires_at > ? `).get(token, now) as SessionQueryRow | undefined if (!row) return null return { id: row.id, username: row.username, display_name: row.display_name, role: row.role, workspace_id: row.workspace_id || getDefaultWorkspaceId(), provider: row.provider || 'local', email: row.email ?? null, avatar_url: row.avatar_url ?? null, is_approved: typeof row.is_approved === 'number' ? row.is_approved : 1, created_at: row.created_at, updated_at: row.updated_at, last_login_at: row.last_login_at, sessionId: row.session_id, } } export function destroySession(token: string): void { const db = getDatabase() db.prepare('DELETE FROM user_sessions WHERE token = ?').run(token) } export function destroyAllUserSessions(userId: number): void { const db = getDatabase() db.prepare('DELETE FROM user_sessions WHERE user_id = ?').run(userId) } // User management export function authenticateUser(username: string, password: string): User | null { const db = getDatabase() const row = db.prepare('SELECT * FROM users WHERE username = ?').get(username) as UserQueryRow | undefined if (!row) return null if ((row.provider || 'local') !== 'local') return null if ((row.is_approved ?? 1) !== 1) return null if (!verifyPassword(password, row.password_hash)) return null return { id: row.id, username: row.username, display_name: row.display_name, role: row.role, workspace_id: row.workspace_id || getDefaultWorkspaceId(), provider: row.provider || 'local', email: row.email ?? null, avatar_url: row.avatar_url ?? null, is_approved: row.is_approved ?? 1, created_at: row.created_at, updated_at: row.updated_at, last_login_at: row.last_login_at, } } export function getUserById(id: number): User | null { const db = getDatabase() const row = db.prepare('SELECT id, username, display_name, role, workspace_id, provider, email, avatar_url, is_approved, created_at, updated_at, last_login_at FROM users WHERE id = ?').get(id) as User | undefined return row || null } export function getAllUsers(): User[] { const db = getDatabase() return db.prepare('SELECT id, username, display_name, role, workspace_id, provider, email, avatar_url, is_approved, created_at, updated_at, last_login_at FROM users ORDER BY created_at').all() as User[] } export function createUser( username: string, password: string, displayName: string, role: User['role'] = 'operator', options?: { provider?: 'local' | 'google'; provider_user_id?: string | null; email?: string | null; avatar_url?: string | null; is_approved?: 0 | 1; approved_by?: string | null; approved_at?: number | null; workspace_id?: number } ): User { const db = getDatabase() if (password.length < 12) throw new Error('Password must be at least 12 characters') const passwordHash = hashPassword(password) const provider = options?.provider || 'local' const workspaceId = options?.workspace_id || getDefaultWorkspaceId() const result = db.prepare(` INSERT INTO users (username, display_name, password_hash, role, provider, provider_user_id, email, avatar_url, is_approved, approved_by, approved_at, workspace_id) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) `).run( username, displayName, passwordHash, role, provider, options?.provider_user_id || null, options?.email || null, options?.avatar_url || null, typeof options?.is_approved === 'number' ? options.is_approved : 1, options?.approved_by || null, options?.approved_at || null, workspaceId, ) return getUserById(Number(result.lastInsertRowid))! } export function updateUser(id: number, updates: { display_name?: string; role?: User['role']; password?: string; email?: string | null; avatar_url?: string | null; is_approved?: 0 | 1 }): User | null { const db = getDatabase() const fields: string[] = [] const params: any[] = [] if (updates.display_name !== undefined) { fields.push('display_name = ?'); params.push(updates.display_name) } if (updates.role !== undefined) { fields.push('role = ?'); params.push(updates.role) } if (updates.password !== undefined) { fields.push('password_hash = ?'); params.push(hashPassword(updates.password)) } if (updates.email !== undefined) { fields.push('email = ?'); params.push(updates.email) } if (updates.avatar_url !== undefined) { fields.push('avatar_url = ?'); params.push(updates.avatar_url) } if (updates.is_approved !== undefined) { fields.push('is_approved = ?'); params.push(updates.is_approved) } if (fields.length === 0) return getUserById(id) fields.push('updated_at = ?') params.push(Math.floor(Date.now() / 1000)) params.push(id) db.prepare(`UPDATE users SET ${fields.join(', ')} WHERE id = ?`).run(...params) return getUserById(id) } export function deleteUser(id: number): boolean { const db = getDatabase() destroyAllUserSessions(id) const result = db.prepare('DELETE FROM users WHERE id = ?').run(id) return result.changes > 0 } /** * Seed admin user from environment variables on first run. * If no users exist, creates an admin from AUTH_USER/AUTH_PASS env vars. */ /** * Get user from request - checks session cookie or API key. * For API key auth, returns a synthetic "api" user. */ export function getUserFromRequest(request: Request): User | null { // Extract agent identity header (optional, for attribution) const agentName = (request.headers.get('x-agent-name') || '').trim() || null // Check session cookie const cookieHeader = request.headers.get('cookie') || '' const sessionToken = parseCookie(cookieHeader, 'mc-session') if (sessionToken) { const user = validateSession(sessionToken) if (user) return { ...user, agent_name: agentName } } // Check API key - return synthetic user const configuredApiKey = (process.env.API_KEY || '').trim() const apiKey = extractApiKeyFromHeaders(request.headers) if (configuredApiKey && apiKey && safeCompare(apiKey, configuredApiKey)) { return { id: 0, username: 'api', display_name: 'API Access', role: 'admin', workspace_id: getDefaultWorkspaceId(), created_at: 0, updated_at: 0, last_login_at: null, agent_name: agentName, } } return null } function extractApiKeyFromHeaders(headers: Headers): string | null { const direct = (headers.get('x-api-key') || '').trim() if (direct) return direct const authorization = (headers.get('authorization') || '').trim() if (!authorization) return null const [scheme, ...rest] = authorization.split(/\s+/) if (!scheme || rest.length === 0) return null const normalized = scheme.toLowerCase() if (normalized === 'bearer' || normalized === 'apikey' || normalized === 'token') { return rest.join(' ').trim() || null } return null } /** * Role hierarchy levels for access control. * viewer < operator < admin */ const ROLE_LEVELS: Record = { viewer: 0, operator: 1, admin: 2 } /** * Check if a user meets the minimum role requirement. * Returns { user } on success, or { error, status } on failure (401 or 403). */ export function requireRole( request: Request, minRole: User['role'] ): { user: User; error?: never; status?: never } | { user?: never; error: string; status: 401 | 403 } { const user = getUserFromRequest(request) if (!user) { return { error: 'Authentication required', status: 401 } } if ((ROLE_LEVELS[user.role] ?? -1) < ROLE_LEVELS[minRole]) { return { error: `Requires ${minRole} role or higher`, status: 403 } } return { user } } function parseCookie(cookieHeader: string, name: string): string | null { const match = cookieHeader.match(new RegExp(`(?:^|;\\s*)${name}=([^;]*)`)) return match ? decodeURIComponent(match[1]) : null }