Add series fields to audiobooks and update related logic

Introduces 'series' and 'seriesPart' fields to the Audiobook model and database schema. Updates API routes, file organization, and path template utilities to support series metadata. Enhances chapter merging logic, improves notification backend testing, and expands test coverage for admin and API routes.
2026-06-02 20:30:10 +00:00 · 2026-01-22 15:56:55 -05:00
parent dc7e557694
commit 31bca0052f
105 changed files with 10384 additions and 75 deletions
@@ -0,0 +1,86 @@
+/**
+ * Component: Admin Account Step Tests
+ * Documentation: documentation/setup-wizard.md
+ */
+
+// @vitest-environment jsdom
+
+import React, { useState } from 'react';
+import { fireEvent, render, screen } from '@testing-library/react';
+import { describe, expect, it, vi } from 'vitest';
+import { AdminAccountStep } from '@/app/setup/steps/AdminAccountStep';
+
+const AdminAccountHarness = ({
+  onNext,
+  onBack,
+  initialUsername = '',
+  initialPassword = '',
+}: {
+  onNext: () => void;
+  onBack: () => void;
+  initialUsername?: string;
+  initialPassword?: string;
+}) => {
+  const [adminUsername, setAdminUsername] = useState(initialUsername);
+  const [adminPassword, setAdminPassword] = useState(initialPassword);
+
+  return (
+    <AdminAccountStep
+      adminUsername={adminUsername}
+      adminPassword={adminPassword}
+      onUpdate={(field, value) => {
+        if (field === 'adminUsername') {
+          setAdminUsername(value);
+        }
+        if (field === 'adminPassword') {
+          setAdminPassword(value);
+        }
+      }}
+      onNext={onNext}
+      onBack={onBack}
+    />
+  );
+};
+
+describe('AdminAccountStep', () => {
+  it('shows validation errors and blocks next when invalid', async () => {
+    const onNext = vi.fn();
+    const onBack = vi.fn();
+    render(
+      <AdminAccountStep
+        adminUsername="ad"
+        adminPassword="short"
+        onUpdate={vi.fn()}
+        onNext={onNext}
+        onBack={onBack}
+      />
+    );
+
+    fireEvent.click(screen.getByRole('button', { name: 'Next' }));
+
+    expect(screen.getByText('Username must be at least 3 characters')).toBeInTheDocument();
+    expect(screen.getByText('Password must be at least 8 characters')).toBeInTheDocument();
+    expect(screen.getByText('Passwords do not match')).toBeInTheDocument();
+    expect(onNext).not.toHaveBeenCalled();
+  });
+
+  it('allows navigation when credentials are valid', async () => {
+    const onNext = vi.fn();
+    const onBack = vi.fn();
+    render(
+      <AdminAccountHarness
+        onNext={onNext}
+        onBack={onBack}
+        initialUsername="admin"
+        initialPassword="supersecret"
+      />
+    );
+
+    fireEvent.change(screen.getByLabelText('Confirm Password'), {
+      target: { value: 'supersecret' },
+    });
+
+    fireEvent.click(screen.getByRole('button', { name: 'Next' }));
+    expect(onNext).toHaveBeenCalled();
+  });
+});