ReadMeABook/tests/api/requests.route.test.ts

/**
 * Component: Requests API Route Tests
 * Documentation: documentation/testing.md
 */

import { beforeEach, describe, expect, it, vi } from 'vitest';
import { createPrismaMock } from '../helpers/prisma';

let authRequest: any;

const prismaMock = createPrismaMock();
const jobQueueMock = vi.hoisted(() => ({ addSearchJob: vi.fn() }));
const findPlexMatchMock = vi.hoisted(() => vi.fn());
const requireAuthMock = vi.hoisted(() => vi.fn());

vi.mock('@/lib/db', () => ({
  prisma: prismaMock,
}));

vi.mock('@/lib/services/job-queue.service', () => ({
  getJobQueueService: () => jobQueueMock,
}));

vi.mock('@/lib/utils/audiobook-matcher', () => ({
  findPlexMatch: findPlexMatchMock,
}));

vi.mock('@/lib/middleware/auth', () => ({
  requireAuth: requireAuthMock,
}));

describe('Requests API routes', () => {
  beforeEach(() => {
    vi.clearAllMocks();
    authRequest = {
      user: { id: 'user-1', role: 'user' },
      nextUrl: new URL('http://localhost/api/requests'),
      json: vi.fn(),
    };
    requireAuthMock.mockImplementation((_req: any, handler: any) => handler(authRequest));
  });

  it('returns 409 when an active request already exists', async () => {
    authRequest.json.mockResolvedValue({
      audiobook: { asin: 'ASIN-1', title: 'Title', author: 'Author' },
    });
    prismaMock.request.findFirst.mockResolvedValueOnce({
      id: 'req-1',
      status: 'downloaded',
      userId: 'user-2',
      user: { plexUsername: 'someone' },
    });

    const { POST } = await import('@/app/api/requests/route');
    const response = await POST({} as any);
    const payload = await response.json();

    expect(response.status).toBe(409);
    expect(payload.error).toBe('BeingProcessed');
    expect(findPlexMatchMock).not.toHaveBeenCalled();
  });

  it('returns 409 when a Plex match already exists', async () => {
    authRequest.json.mockResolvedValue({
      audiobook: { asin: 'ASIN-2', title: 'Title', author: 'Author' },
    });
    prismaMock.request.findFirst.mockResolvedValueOnce(null);
    findPlexMatchMock.mockResolvedValueOnce({ plexGuid: 'plex-1' });

    const { POST } = await import('@/app/api/requests/route');
    const response = await POST({} as any);
    const payload = await response.json();

    expect(response.status).toBe(409);
    expect(payload.error).toBe('AlreadyAvailable');
  });

  it('creates a new request and enqueues a search job', async () => {
    authRequest.json.mockResolvedValue({
      audiobook: { asin: 'ASIN-3', title: 'Title', author: 'Author' },
    });
    prismaMock.request.findFirst.mockResolvedValueOnce(null);
    findPlexMatchMock.mockResolvedValueOnce(null);
    prismaMock.audiobook.findFirst.mockResolvedValueOnce(null);
    prismaMock.audiobook.create.mockResolvedValueOnce({
      id: 'ab-1',
      title: 'Title',
      author: 'Author',
      audibleAsin: 'ASIN-3',
    });
    prismaMock.request.findFirst.mockResolvedValueOnce(null);
    prismaMock.request.create.mockResolvedValueOnce({
      id: 'req-2',
      audiobook: { id: 'ab-1', title: 'Title', author: 'Author', audibleAsin: 'ASIN-3' },
      user: { id: 'user-1', plexUsername: 'user' },
    });

    const { POST } = await import('@/app/api/requests/route');
    const response = await POST({} as any);
    const payload = await response.json();

    expect(response.status).toBe(201);
    expect(payload.success).toBe(true);
    expect(jobQueueMock.addSearchJob).toHaveBeenCalledWith('req-2', {
      id: 'ab-1',
      title: 'Title',
      author: 'Author',
      asin: 'ASIN-3',
    });
  });

  it('skips auto-search when skipAutoSearch=true', async () => {
    authRequest.nextUrl = new URL('http://localhost/api/requests?skipAutoSearch=true');
    authRequest.json.mockResolvedValue({
      audiobook: { asin: 'ASIN-4', title: 'Title', author: 'Author' },
    });
    prismaMock.request.findFirst.mockResolvedValueOnce(null);
    findPlexMatchMock.mockResolvedValueOnce(null);
    prismaMock.audiobook.findFirst.mockResolvedValueOnce(null);
    prismaMock.audiobook.create.mockResolvedValueOnce({
      id: 'ab-2',
      title: 'Title',
      author: 'Author',
      audibleAsin: 'ASIN-4',
    });
    prismaMock.request.findFirst.mockResolvedValueOnce(null);
    prismaMock.request.create.mockResolvedValueOnce({
      id: 'req-3',
      audiobook: { id: 'ab-2', title: 'Title', author: 'Author', audibleAsin: 'ASIN-4' },
      user: { id: 'user-1', plexUsername: 'user' },
    });

    const { POST } = await import('@/app/api/requests/route');
    await POST({} as any);

    expect(jobQueueMock.addSearchJob).not.toHaveBeenCalled();
    expect(prismaMock.request.create).toHaveBeenCalledWith(
      expect.objectContaining({
        data: expect.objectContaining({ status: 'awaiting_search' }),
      })
    );
  });

  it('filters requests for current user when not admin', async () => {
    authRequest.nextUrl = new URL('http://localhost/api/requests?status=pending&limit=5');
    prismaMock.request.findMany.mockResolvedValueOnce([]);

    const { GET } = await import('@/app/api/requests/route');
    const response = await GET({} as any);
    const payload = await response.json();

    expect(response.status).toBe(200);
    expect(payload.success).toBe(true);
    expect(prismaMock.request.findMany).toHaveBeenCalledWith(
      expect.objectContaining({
        where: expect.objectContaining({ userId: 'user-1', status: 'pending' }),
        take: 5,
      })
    );
  });
});