/** * @fileoverview Tests for session route handlers. * * Uses app.inject() (Fastify's built-in test helper) — no real HTTP ports needed. * Port: N/A (app.inject doesn't open ports) */ import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest'; import { createRouteTestHarness, type RouteTestHarness } from './_route-test-utils.js'; import { registerSessionRoutes } from '../../src/web/routes/session-routes.js'; describe('session-routes', () => { let harness: RouteTestHarness; beforeEach(async () => { harness = await createRouteTestHarness(registerSessionRoutes); }); afterEach(async () => { await harness.app.close(); }); // ========== GET /api/sessions ========== describe('GET /api/sessions', () => { it('returns session list when sessions exist', async () => { const res = await harness.app.inject({ method: 'GET', url: '/api/sessions' }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(Array.isArray(body)).toBe(true); expect(body).toHaveLength(1); }); it('returns empty array when no sessions', async () => { harness.ctx.sessions.clear(); const res = await harness.app.inject({ method: 'GET', url: '/api/sessions' }); expect(res.statusCode).toBe(200); expect(JSON.parse(res.body)).toEqual([]); }); }); // ========== GET /api/sessions/:id ========== describe('GET /api/sessions/:id', () => { it('returns session state for existing session', async () => { const res = await harness.app.inject({ method: 'GET', url: `/api/sessions/${harness.ctx._sessionId}`, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.id).toBe(harness.ctx._sessionId); }); it('returns error for unknown session', async () => { const res = await harness.app.inject({ method: 'GET', url: '/api/sessions/nonexistent', }); expect(res.statusCode).toBe(200); // returns error in body, not HTTP 404 const body = JSON.parse(res.body); expect(body.success).toBe(false); expect(body.error).toBeDefined(); }); }); // ========== DELETE /api/sessions/:id ========== describe('DELETE /api/sessions/:id', () => { it('deletes existing session', async () => { const res = await harness.app.inject({ method: 'DELETE', url: `/api/sessions/${harness.ctx._sessionId}`, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(true); expect(harness.ctx.cleanupSession).toHaveBeenCalledWith( harness.ctx._sessionId, true, 'user_delete', ); }); it('returns error for unknown session', async () => { const res = await harness.app.inject({ method: 'DELETE', url: '/api/sessions/nonexistent', }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(false); }); }); // ========== DELETE /api/sessions (delete all) ========== describe('DELETE /api/sessions', () => { it('deletes all sessions', async () => { const res = await harness.app.inject({ method: 'DELETE', url: '/api/sessions', }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(true); expect(body.data.killed).toBe(1); expect(harness.ctx.cleanupSession).toHaveBeenCalled(); }); }); // ========== PUT /api/sessions/:id/name ========== describe('PUT /api/sessions/:id/name', () => { it('renames session', async () => { const res = await harness.app.inject({ method: 'PUT', url: `/api/sessions/${harness.ctx._sessionId}/name`, payload: { name: 'new-name' }, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(true); expect(body.name).toBe('new-name'); expect(harness.ctx.persistSessionState).toHaveBeenCalled(); expect(harness.ctx.broadcast).toHaveBeenCalledWith( 'session:updated', expect.anything(), ); }); it('returns error for unknown session', async () => { const res = await harness.app.inject({ method: 'PUT', url: '/api/sessions/nonexistent/name', payload: { name: 'test' }, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(false); }); }); // ========== PUT /api/sessions/:id/color ========== describe('PUT /api/sessions/:id/color', () => { it('sets session color', async () => { const res = await harness.app.inject({ method: 'PUT', url: `/api/sessions/${harness.ctx._sessionId}/color`, payload: { color: 'blue' }, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(true); expect(body.color).toBe('blue'); }); it('rejects invalid color', async () => { const res = await harness.app.inject({ method: 'PUT', url: `/api/sessions/${harness.ctx._sessionId}/color`, payload: { color: 'neon-rainbow' }, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(false); }); }); // ========== POST /api/sessions/:id/input ========== describe('POST /api/sessions/:id/input', () => { it('sends input to session', async () => { const res = await harness.app.inject({ method: 'POST', url: `/api/sessions/${harness.ctx._sessionId}/input`, payload: { input: 'hello' }, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(true); }); it('returns error for unknown session', async () => { const res = await harness.app.inject({ method: 'POST', url: '/api/sessions/nonexistent/input', payload: { input: 'hello' }, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(false); }); it('rejects empty payload', async () => { const res = await harness.app.inject({ method: 'POST', url: `/api/sessions/${harness.ctx._sessionId}/input`, payload: {}, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(false); }); }); // ========== POST /api/sessions/:id/resize ========== describe('POST /api/sessions/:id/resize', () => { it('resizes session terminal', async () => { const res = await harness.app.inject({ method: 'POST', url: `/api/sessions/${harness.ctx._sessionId}/resize`, payload: { cols: 120, rows: 40 }, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(true); expect(harness.ctx._session.resize).toHaveBeenCalledWith(120, 40); }); it('rejects cols exceeding max (500)', async () => { const res = await harness.app.inject({ method: 'POST', url: `/api/sessions/${harness.ctx._sessionId}/resize`, payload: { cols: 501, rows: 24 }, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(false); }); it('rejects rows exceeding max (200)', async () => { const res = await harness.app.inject({ method: 'POST', url: `/api/sessions/${harness.ctx._sessionId}/resize`, payload: { cols: 80, rows: 201 }, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(false); }); it('rejects zero dimensions', async () => { const res = await harness.app.inject({ method: 'POST', url: `/api/sessions/${harness.ctx._sessionId}/resize`, payload: { cols: 0, rows: 24 }, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(false); }); }); // ========== GET /api/sessions/:id/terminal ========== describe('GET /api/sessions/:id/terminal', () => { it('returns terminal buffer', async () => { harness.ctx._session.terminalBuffer = 'hello world'; const res = await harness.app.inject({ method: 'GET', url: `/api/sessions/${harness.ctx._sessionId}/terminal`, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.terminalBuffer).toBeDefined(); }); it('returns error for unknown session', async () => { const res = await harness.app.inject({ method: 'GET', url: '/api/sessions/nonexistent/terminal', }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(false); }); }); // ========== POST /api/sessions/:id/run ========== describe('POST /api/sessions/:id/run', () => { it('runs prompt on session', async () => { const res = await harness.app.inject({ method: 'POST', url: `/api/sessions/${harness.ctx._sessionId}/run`, payload: { prompt: 'do something' }, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(true); }); it('rejects empty prompt', async () => { const res = await harness.app.inject({ method: 'POST', url: `/api/sessions/${harness.ctx._sessionId}/run`, payload: { prompt: '' }, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(false); }); it('returns error for unknown session', async () => { const res = await harness.app.inject({ method: 'POST', url: '/api/sessions/nonexistent/run', payload: { prompt: 'test' }, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(false); }); it('returns error if session is busy', async () => { harness.ctx._session.isBusy.mockReturnValue(true); const res = await harness.app.inject({ method: 'POST', url: `/api/sessions/${harness.ctx._sessionId}/run`, payload: { prompt: 'test' }, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(false); }); }); // ========== POST /api/sessions/:id/interactive ========== describe('POST /api/sessions/:id/interactive', () => { it('starts interactive mode', async () => { const res = await harness.app.inject({ method: 'POST', url: `/api/sessions/${harness.ctx._sessionId}/interactive`, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(true); expect(harness.ctx._session.startInteractive).toHaveBeenCalled(); }); it('returns error for unknown session', async () => { const res = await harness.app.inject({ method: 'POST', url: '/api/sessions/nonexistent/interactive', }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(false); }); it('returns error if session is busy', async () => { harness.ctx._session.isBusy.mockReturnValue(true); const res = await harness.app.inject({ method: 'POST', url: `/api/sessions/${harness.ctx._sessionId}/interactive`, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(false); }); }); // ========== POST /api/sessions/:id/shell ========== describe('POST /api/sessions/:id/shell', () => { it('starts shell mode', async () => { const res = await harness.app.inject({ method: 'POST', url: `/api/sessions/${harness.ctx._sessionId}/shell`, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(true); expect(harness.ctx._session.startShell).toHaveBeenCalled(); }); it('returns error if session is busy', async () => { harness.ctx._session.isBusy.mockReturnValue(true); const res = await harness.app.inject({ method: 'POST', url: `/api/sessions/${harness.ctx._sessionId}/shell`, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(false); }); }); // ========== GET /api/sessions/:id/output ========== describe('GET /api/sessions/:id/output', () => { it('returns session output data', async () => { const res = await harness.app.inject({ method: 'GET', url: `/api/sessions/${harness.ctx._sessionId}/output`, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(true); expect(body.data).toHaveProperty('textOutput'); expect(body.data).toHaveProperty('messages'); expect(body.data).toHaveProperty('errorBuffer'); }); it('returns error for unknown session', async () => { const res = await harness.app.inject({ method: 'GET', url: '/api/sessions/nonexistent/output', }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(false); }); }); // ========== GET /api/sessions/:id/ralph-state ========== describe('GET /api/sessions/:id/ralph-state', () => { it('returns ralph state data', async () => { const res = await harness.app.inject({ method: 'GET', url: `/api/sessions/${harness.ctx._sessionId}/ralph-state`, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(true); expect(body.data).toHaveProperty('loop'); expect(body.data).toHaveProperty('todos'); expect(body.data).toHaveProperty('todoStats'); }); }); // ========== GET /api/sessions/:id/active-tools ========== describe('GET /api/sessions/:id/active-tools', () => { it('returns active tools', async () => { const res = await harness.app.inject({ method: 'GET', url: `/api/sessions/${harness.ctx._sessionId}/active-tools`, }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(true); expect(body.data).toHaveProperty('tools'); }); }); // ========== POST /api/logout ========== describe('POST /api/logout', () => { it('returns success', async () => { const res = await harness.app.inject({ method: 'POST', url: '/api/logout', }); expect(res.statusCode).toBe(200); const body = JSON.parse(res.body); expect(body.success).toBe(true); }); }); });