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-03 12:50:09 +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,109 @@
+/**
+ * Component: E-book Settings Tab - Custom Hook
+ * Documentation: documentation/settings-pages.md
+ */
+
+'use client';
+
+import { useState } from 'react';
+import { fetchWithAuth } from '@/lib/utils/api';
+import type { EbookSettings, TestResult } from '../../lib/types';
+
+interface UseEbookSettingsProps {
+  ebook: EbookSettings;
+  onChange: (ebook: EbookSettings) => void;
+  onSuccess: (message: string) => void;
+  onError: (message: string) => void;
+  markAsSaved: () => void;
+}
+
+export function useEbookSettings({ ebook, onChange, onSuccess, onError, markAsSaved }: UseEbookSettingsProps) {
+  const [saving, setSaving] = useState(false);
+  const [testingFlaresolverr, setTestingFlaresolverr] = useState(false);
+  const [flaresolverrTestResult, setFlaresolverrTestResult] = useState<TestResult | null>(null);
+
+  /**
+   * Update a single ebook field
+   */
+  const updateEbook = (field: keyof EbookSettings, value: string | boolean) => {
+    onChange({ ...ebook, [field]: value });
+    if (field === 'flaresolverrUrl') {
+      setFlaresolverrTestResult(null);
+    }
+  };
+
+  /**
+   * Test FlareSolverr connection
+   */
+  const testFlaresolverrConnection = async () => {
+    if (!ebook.flaresolverrUrl) {
+      setFlaresolverrTestResult({
+        success: false,
+        message: 'Please enter a FlareSolverr URL first',
+      });
+      return;
+    }
+
+    setTestingFlaresolverr(true);
+    setFlaresolverrTestResult(null);
+
+    try {
+      const response = await fetchWithAuth('/api/admin/settings/ebook/test-flaresolverr', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ url: ebook.flaresolverrUrl }),
+      });
+
+      const result = await response.json();
+      setFlaresolverrTestResult(result);
+    } catch (error) {
+      setFlaresolverrTestResult({
+        success: false,
+        message: error instanceof Error ? error.message : 'Test failed',
+      });
+    } finally {
+      setTestingFlaresolverr(false);
+    }
+  };
+
+  /**
+   * Save e-book settings to API
+   */
+  const saveSettings = async () => {
+    setSaving(true);
+
+    try {
+      const response = await fetchWithAuth('/api/admin/settings/ebook', {
+        method: 'PUT',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          enabled: ebook.enabled || false,
+          format: ebook.preferredFormat || 'epub',
+          baseUrl: ebook.baseUrl || 'https://annas-archive.li',
+          flaresolverrUrl: ebook.flaresolverrUrl || '',
+        }),
+      });
+
+      if (!response.ok) {
+        throw new Error('Failed to save e-book settings');
+      }
+
+      onSuccess('E-book sidecar settings saved successfully!');
+      markAsSaved();
+      setTimeout(() => onSuccess(''), 3000);
+    } catch (error) {
+      onError(error instanceof Error ? error.message : 'Failed to save e-book settings');
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  return {
+    saving,
+    testingFlaresolverr,
+    flaresolverrTestResult,
+    updateEbook,
+    testFlaresolverrConnection,
+    saveSettings,
+  };
+}