Add backend unit test framework and modularize settings UI

Introduced a Vitest-based backend unit testing framework with supporting scripts, helpers, and GitHub Actions integration. Refactored the admin settings page to a modular architecture, splitting monolithic logic into feature-specific tabs and hooks for improved maintainability and testability. Updated documentation to reflect the new testing setup and settings architecture, and added new dependencies for testing utilities.
2026-06-02 20:30:10 +00:00 · 2026-01-15 16:49:59 -05:00
parent b3f89d67bb
commit 94dbaf073b
127 changed files with 23549 additions and 2868 deletions
@@ -0,0 +1,128 @@
+/**
+ * Component: Search Indexers Processor Tests
+ * Documentation: documentation/backend/services/jobs.md
+ */
+
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { createPrismaMock } from '../helpers/prisma';
+import { createJobQueueMock } from '../helpers/job-queue';
+
+const prismaMock = createPrismaMock();
+const configMock = vi.hoisted(() => ({ get: vi.fn() }));
+const jobQueueMock = createJobQueueMock();
+const prowlarrMock = vi.hoisted(() => ({ search: vi.fn() }));
+
+vi.mock('@/lib/db', () => ({
+  prisma: prismaMock,
+}));
+
+vi.mock('@/lib/services/config.service', () => ({
+  getConfigService: () => configMock,
+}));
+
+vi.mock('@/lib/services/job-queue.service', () => ({
+  getJobQueueService: () => jobQueueMock,
+}));
+
+vi.mock('@/lib/integrations/prowlarr.service', () => ({
+  getProwlarrService: () => prowlarrMock,
+}));
+
+vi.mock('@/lib/integrations/audible.service', () => ({
+  getAudibleService: () => ({ getRuntime: vi.fn().mockResolvedValue(null) }),
+}));
+
+describe('processSearchIndexers', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it('marks request awaiting_search when no results found', async () => {
+    configMock.get.mockImplementation(async (key: string) => {
+      if (key === 'prowlarr_indexers') {
+        return JSON.stringify([{ id: 1, name: 'Indexer', priority: 10, categories: [3030] }]);
+      }
+      return null;
+    });
+    prowlarrMock.search.mockResolvedValue([]);
+    prismaMock.request.update.mockResolvedValue({});
+
+    const { processSearchIndexers } = await import('@/lib/processors/search-indexers.processor');
+    const result = await processSearchIndexers({
+      requestId: 'req-1',
+      audiobook: { id: 'a1', title: 'Book', author: 'Author' },
+      jobId: 'job-1',
+    });
+
+    expect(result.success).toBe(false);
+    expect(prismaMock.request.update).toHaveBeenCalledWith(
+      expect.objectContaining({
+        data: expect.objectContaining({ status: 'awaiting_search' }),
+      })
+    );
+  });
+
+  it('queues download job when results are ranked', async () => {
+    configMock.get.mockImplementation(async (key: string) => {
+      if (key === 'prowlarr_indexers') {
+        return JSON.stringify([{ id: 1, name: 'Indexer', priority: 10, categories: [3030] }]);
+      }
+      if (key === 'indexer_flag_config') {
+        return JSON.stringify([]);
+      }
+      return null;
+    });
+
+    prowlarrMock.search.mockResolvedValue([
+      {
+        indexer: 'Indexer',
+        indexerId: 1,
+        title: 'Book - Author',
+        size: 50 * 1024 * 1024,
+        seeders: 10,
+        publishDate: new Date(),
+        downloadUrl: 'magnet:?xt=urn:btih:abc',
+        guid: 'guid-1',
+        format: 'M4B',
+      },
+    ]);
+
+    prismaMock.request.update.mockResolvedValue({});
+
+    const { processSearchIndexers } = await import('@/lib/processors/search-indexers.processor');
+    const result = await processSearchIndexers({
+      requestId: 'req-2',
+      audiobook: { id: 'a2', title: 'Book', author: 'Author' },
+      jobId: 'job-2',
+    });
+
+    expect(result.success).toBe(true);
+    expect(jobQueueMock.addDownloadJob).toHaveBeenCalledWith(
+      'req-2',
+      { id: 'a2', title: 'Book', author: 'Author' },
+      expect.objectContaining({ title: 'Book - Author' })
+    );
+  });
+
+  it('fails when no indexers are configured', async () => {
+    configMock.get.mockResolvedValue(null);
+    prismaMock.request.update.mockResolvedValue({});
+
+    const { processSearchIndexers } = await import('@/lib/processors/search-indexers.processor');
+    await expect(
+      processSearchIndexers({
+        requestId: 'req-3',
+        audiobook: { id: 'a3', title: 'Book', author: 'Author' },
+        jobId: 'job-3',
+      })
+    ).rejects.toThrow('No indexers configured');
+
+    expect(prismaMock.request.update).toHaveBeenCalledWith(
+      expect.objectContaining({
+        data: expect.objectContaining({ status: 'failed' }),
+      })
+    );
+  });
+});
+
+