Add notification system with admin UI and backend

Introduces a full notification system with support for Discord and Pushover backends, event triggers, and message formatting. Adds backend services, processors, and API endpoints for managing notifications, as well as a new Notifications tab in the admin settings UI. Updates documentation, database schema, and tests to cover notification features and approval workflow improvements. Also changes project license from MIT to AGPL v3.
2026-06-02 20:30:10 +00:00 · 2026-01-21 15:28:23 -05:00
parent ac2ad8aac2
commit dc7e557694
51 changed files with 5065 additions and 264 deletions
@@ -0,0 +1,118 @@
+/**
+ * Component: Send Notification Processor Tests
+ * Documentation: documentation/backend/services/notifications.md
+ */
+
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+const notificationServiceMock = vi.hoisted(() => ({
+  sendNotification: vi.fn(),
+}));
+
+vi.mock('@/lib/services/notification.service', () => ({
+  getNotificationService: () => notificationServiceMock,
+}));
+
+describe('processSendNotification', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it('calls notification service with correct payload', async () => {
+    const { processSendNotification } = await import('@/lib/processors/send-notification.processor');
+
+    const payload = {
+      event: 'request_approved' as const,
+      requestId: 'req-1',
+      title: 'Test Book',
+      author: 'Test Author',
+      userName: 'Test User',
+      timestamp: new Date('2024-01-01T00:00:00Z'),
+      jobId: 'job-1',
+    };
+
+    await processSendNotification(payload);
+
+    expect(notificationServiceMock.sendNotification).toHaveBeenCalledWith({
+      event: 'request_approved',
+      requestId: 'req-1',
+      title: 'Test Book',
+      author: 'Test Author',
+      userName: 'Test User',
+      timestamp: expect.any(Date),
+    });
+  });
+
+  it('includes error message if provided', async () => {
+    const { processSendNotification } = await import('@/lib/processors/send-notification.processor');
+
+    const payload = {
+      event: 'request_error' as const,
+      requestId: 'req-1',
+      title: 'Test Book',
+      author: 'Test Author',
+      userName: 'Test User',
+      message: 'Download failed',
+      timestamp: new Date('2024-01-01T00:00:00Z'),
+      jobId: 'job-1',
+    };
+
+    await processSendNotification(payload);
+
+    expect(notificationServiceMock.sendNotification).toHaveBeenCalledWith({
+      event: 'request_error',
+      requestId: 'req-1',
+      title: 'Test Book',
+      author: 'Test Author',
+      userName: 'Test User',
+      message: 'Download failed',
+      timestamp: expect.any(Date),
+    });
+  });
+
+  it('does not throw if notification service fails', async () => {
+    notificationServiceMock.sendNotification.mockRejectedValue(new Error('Service error'));
+
+    const { processSendNotification } = await import('@/lib/processors/send-notification.processor');
+
+    const payload = {
+      event: 'request_approved' as const,
+      requestId: 'req-1',
+      title: 'Test Book',
+      author: 'Test Author',
+      userName: 'Test User',
+      timestamp: new Date('2024-01-01T00:00:00Z'),
+      jobId: 'job-1',
+    };
+
+    // Should not throw
+    await expect(processSendNotification(payload)).resolves.toBeUndefined();
+  });
+
+  it('processes all event types correctly', async () => {
+    const { processSendNotification } = await import('@/lib/processors/send-notification.processor');
+
+    const events: Array<'request_pending_approval' | 'request_approved' | 'request_available' | 'request_error'> = [
+      'request_pending_approval',
+      'request_approved',
+      'request_available',
+      'request_error',
+    ];
+
+    for (const event of events) {
+      const payload = {
+        event,
+        requestId: 'req-1',
+        title: 'Test Book',
+        author: 'Test Author',
+        userName: 'Test User',
+        timestamp: new Date('2024-01-01T00:00:00Z'),
+        jobId: 'job-1',
+      };
+
+      await processSendNotification(payload);
+    }
+
+    expect(notificationServiceMock.sendNotification).toHaveBeenCalledTimes(4);
+  });
+});