Implement file hash-based library matching and remove fuzzy ASIN matching

Adds file hash-based matching for Audiobookshelf library items to ensure 100% accurate ASIN assignment for RMAB-organized content. Removes fuzzy matching from library availability checks, making all matching ASIN-only to eliminate false positives and race conditions. Updates database schema, processors, and matcher utilities; adds new tests and documentation for the new matching strategy. Removes obsolete scripts, Dockerfile, and related tests; updates docker-compose for test environments.
2026-06-03 21:00:09 +00:00 · 2026-01-28 10:32:14 -05:00
parent 497849f427
commit a97979358f
111 changed files with 6571 additions and 1426 deletions
@@ -0,0 +1,130 @@
+/**
+ * Component: Download Settings Hook Tests
+ * Documentation: documentation/settings-pages.md
+ */
+
+// @vitest-environment jsdom
+
+import React from 'react';
+import { act, render, waitFor } from '@testing-library/react';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+const fetchWithAuthMock = vi.hoisted(() => vi.fn());
+
+vi.mock('@/lib/utils/api', () => ({
+  fetchWithAuth: fetchWithAuthMock,
+}));
+
+const renderHook = <T,>(hook: () => T) => {
+  const result = { current: undefined as T };
+  function Probe() {
+    result.current = hook();
+    return null;
+  }
+  render(<Probe />);
+  return result;
+};
+
+const downloadClient = {
+  type: 'qbittorrent',
+  url: 'http://host',
+  username: 'user',
+  password: 'pass',
+  disableSSLVerify: false,
+  remotePathMappingEnabled: false,
+  remotePath: '',
+  localPath: '',
+};
+
+describe('useDownloadSettings', () => {
+  const onChange = vi.fn();
+  const onValidationChange = vi.fn();
+
+  beforeEach(() => {
+    fetchWithAuthMock.mockReset();
+    onChange.mockReset();
+    onValidationChange.mockReset();
+  });
+
+  it('updates fields and resets validation', async () => {
+    const { useDownloadSettings } = await import('@/app/admin/settings/tabs/DownloadTab/useDownloadSettings');
+    const result = renderHook(() => useDownloadSettings({ downloadClient, onChange, onValidationChange }));
+
+    act(() => {
+      result.current.updateField('url', 'http://new');
+    });
+
+    expect(onChange).toHaveBeenCalledWith({ ...downloadClient, url: 'http://new' });
+    expect(onValidationChange).toHaveBeenCalledWith(false);
+  });
+
+  it('resets credentials when changing download client type', async () => {
+    const { useDownloadSettings } = await import('@/app/admin/settings/tabs/DownloadTab/useDownloadSettings');
+    const result = renderHook(() => useDownloadSettings({ downloadClient, onChange, onValidationChange }));
+
+    act(() => {
+      result.current.handleTypeChange('sabnzbd');
+    });
+
+    expect(onChange).toHaveBeenCalledWith({
+      ...downloadClient,
+      type: 'sabnzbd',
+      username: '',
+      password: '',
+    });
+    expect(onValidationChange).toHaveBeenCalledWith(false);
+  });
+
+  it('tests the download client connection successfully', async () => {
+    fetchWithAuthMock.mockResolvedValueOnce({
+      ok: true,
+      json: async () => ({ success: true, version: '1.2.3' }),
+    });
+
+    const { useDownloadSettings } = await import('@/app/admin/settings/tabs/DownloadTab/useDownloadSettings');
+    const result = renderHook(() => useDownloadSettings({ downloadClient, onChange, onValidationChange }));
+
+    await act(async () => {
+      const response = await result.current.testConnection();
+      expect(response?.success).toBe(true);
+    });
+
+    await waitFor(() => {
+      expect(result.current.testResult?.message).toContain('qbittorrent');
+    });
+    expect(onValidationChange).toHaveBeenCalledWith(true);
+  });
+
+  it('handles download client test failures', async () => {
+    fetchWithAuthMock.mockResolvedValueOnce({
+      ok: true,
+      json: async () => ({ success: false, error: 'Bad credentials' }),
+    });
+
+    const { useDownloadSettings } = await import('@/app/admin/settings/tabs/DownloadTab/useDownloadSettings');
+    const result = renderHook(() => useDownloadSettings({ downloadClient, onChange, onValidationChange }));
+
+    await act(async () => {
+      const response = await result.current.testConnection();
+      expect(response?.success).toBe(false);
+    });
+
+    expect(result.current.testResult?.message).toBe('Bad credentials');
+    expect(onValidationChange).toHaveBeenCalledWith(false);
+  });
+
+  it('handles download client test exceptions', async () => {
+    fetchWithAuthMock.mockRejectedValueOnce(new Error('network down'));
+
+    const { useDownloadSettings } = await import('@/app/admin/settings/tabs/DownloadTab/useDownloadSettings');
+    const result = renderHook(() => useDownloadSettings({ downloadClient, onChange, onValidationChange }));
+
+    await act(async () => {
+      const response = await result.current.testConnection();
+      expect(response?.success).toBe(false);
+    });
+
+    expect(result.current.testResult?.message).toBe('network down');
+    expect(onValidationChange).toHaveBeenCalledWith(false);
+  });
+});