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,147 @@
+/**
+ * Component: Audiobookshelf API Client Tests
+ * Documentation: documentation/features/audiobookshelf-integration.md
+ */
+
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import {
+  absRequest,
+  getABSLibraries,
+  getABSLibraryItems,
+  getABSRecentItems,
+  getABSServerInfo,
+  searchABSItems,
+  triggerABSItemMatch,
+  triggerABSScan,
+} from '@/lib/services/audiobookshelf/api';
+
+const configServiceMock = vi.hoisted(() => ({
+  get: vi.fn(),
+}));
+
+const fetchMock = vi.hoisted(() => vi.fn());
+
+vi.mock('@/lib/services/config.service', () => ({
+  getConfigService: () => configServiceMock,
+}));
+
+describe('Audiobookshelf API client', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    configServiceMock.get.mockReset();
+    fetchMock.mockReset();
+    vi.stubGlobal('fetch', fetchMock);
+  });
+
+  it('throws when Audiobookshelf config is missing', async () => {
+    configServiceMock.get.mockResolvedValue(null);
+
+    await expect(absRequest('/status')).rejects.toThrow('Audiobookshelf not configured');
+  });
+
+  it('returns parsed JSON for successful requests', async () => {
+    configServiceMock.get.mockImplementation(async (key: string) => {
+      if (key === 'audiobookshelf.server_url') return 'http://abs';
+      if (key === 'audiobookshelf.api_token') return 'token';
+      return null;
+    });
+    fetchMock.mockResolvedValue({
+      ok: true,
+      json: async () => ({ version: '2.0.0', name: 'ABS' }),
+    });
+
+    const info = await getABSServerInfo();
+
+    expect(info).toEqual({ version: '2.0.0', name: 'ABS' });
+    expect(fetchMock).toHaveBeenCalledWith('http://abs/api/status', expect.any(Object));
+  });
+
+  it('maps library responses and search queries', async () => {
+    configServiceMock.get.mockImplementation(async (key: string) => {
+      if (key === 'audiobookshelf.server_url') return 'http://abs';
+      if (key === 'audiobookshelf.api_token') return 'token';
+      return null;
+    });
+
+    fetchMock
+      .mockResolvedValueOnce({
+        ok: true,
+        json: async () => ({ libraries: [{ id: 'lib-1' }] }),
+      })
+      .mockResolvedValueOnce({
+        ok: true,
+        json: async () => ({ results: [{ id: 'item-1' }] }),
+      })
+      .mockResolvedValueOnce({
+        ok: true,
+        json: async () => ({ results: [{ id: 'recent-1' }] }),
+      })
+      .mockResolvedValueOnce({
+        ok: true,
+        json: async () => ({ book: [{ id: 'result-1' }] }),
+      });
+
+    expect(await getABSLibraries()).toEqual([{ id: 'lib-1' }]);
+    expect(await getABSLibraryItems('lib-1')).toEqual([{ id: 'item-1' }]);
+    expect(await getABSRecentItems('lib-1', 5)).toEqual([{ id: 'recent-1' }]);
+    expect(await searchABSItems('lib-1', 'hello world')).toEqual([{ id: 'result-1' }]);
+
+    expect(fetchMock.mock.calls[1][0]).toBe('http://abs/api/libraries/lib-1/items');
+    expect(fetchMock.mock.calls[2][0]).toBe('http://abs/api/libraries/lib-1/items?sort=addedAt&desc=1&limit=5');
+    expect(fetchMock.mock.calls[3][0]).toBe('http://abs/api/libraries/lib-1/search?q=hello%20world');
+  });
+
+  it('triggers library scan using plain text responses', async () => {
+    configServiceMock.get.mockImplementation(async (key: string) => {
+      if (key === 'audiobookshelf.server_url') return 'http://abs';
+      if (key === 'audiobookshelf.api_token') return 'token';
+      return null;
+    });
+    fetchMock.mockResolvedValue({
+      ok: true,
+      text: async () => 'OK',
+    });
+
+    await triggerABSScan('lib-1');
+
+    expect(fetchMock).toHaveBeenCalledWith('http://abs/api/libraries/lib-1/scan', expect.objectContaining({
+      method: 'POST',
+    }));
+  });
+
+  it('includes ASIN overrides in metadata match requests', async () => {
+    configServiceMock.get.mockImplementation(async (key: string) => {
+      if (key === 'audiobookshelf.server_url') return 'http://abs';
+      if (key === 'audiobookshelf.api_token') return 'token';
+      return null;
+    });
+    fetchMock.mockResolvedValue({
+      ok: true,
+      json: async () => ({}),
+    });
+
+    await triggerABSItemMatch('item-1', 'ASIN123');
+
+    const body = JSON.parse(fetchMock.mock.calls[0][1].body);
+    expect(body).toEqual({
+      provider: 'audible',
+      asin: 'ASIN123',
+      overrideDefaults: true,
+    });
+  });
+
+  it('suppresses errors when metadata match fails', async () => {
+    configServiceMock.get.mockImplementation(async (key: string) => {
+      if (key === 'audiobookshelf.server_url') return 'http://abs';
+      if (key === 'audiobookshelf.api_token') return 'token';
+      return null;
+    });
+    fetchMock.mockResolvedValue({
+      ok: false,
+      status: 500,
+      statusText: 'Boom',
+    });
+
+    await expect(triggerABSItemMatch('item-1', 'ASIN123')).resolves.toBeUndefined();
+  });
+});