Add extensible notification providers + UI/API

Introduce a provider-based notification system and wire it through the API and admin UI. Added INotificationProvider + notification service implementation and providers (apprise, discord, ntfy, pushover), plus a GET /api/admin/notifications/providers endpoint to expose provider metadata. Refactored code to use provider type strings (removed enum coupling), updated masking/encryption calls, and simplified the test notification endpoint to accept backendId or type+config and call sendToBackend directly. UI: NotificationsTab now fetches provider metadata and renders provider cards and dynamic config forms (fields driven by provider metadata). Added config field rendering, improved backend cards, and edit/delete actions. APIs: New providers route, updated admin notification CRUD routes to validate provider types dynamically, updated test route schema. Added download-client categories POST API to fetch categories from clients and wired postImportCategory handling in download-client routes. Other notable changes: BookDate now fetches Claude models dynamically from Anthropic's Models API; added paginated model fetch helper. Added ALLOW_WEAK_PASSWORD flag exposure to auth providers and password change logic. Doc updates and various tests added/updated. File-organization doc clarifies EPERM fix using stream-based copy.
2026-07-14 00:31:11 +00:00 · 2026-02-10 15:06:20 -05:00
parent 4a38dd3da8
commit af0eaceb98
73 changed files with 3421 additions and 866 deletions
@@ -0,0 +1,121 @@
+/**
+ * Component: Pushover Notification Provider
+ * Documentation: documentation/backend/services/notifications.md
+ */
+
+import { INotificationProvider, NotificationPayload, ProviderMetadata } from '../INotificationProvider';
+
+export interface PushoverConfig {
+  userKey: string;
+  appToken: string;
+  device?: string;
+  priority?: number;
+}
+
+// Pushover priorities by event type
+const PUSHOVER_PRIORITIES = {
+  request_pending_approval: 0, // Normal
+  request_approved: 0, // Normal
+  request_available: 1, // High
+  request_error: 1, // High
+};
+
+export class PushoverProvider implements INotificationProvider {
+  type = 'pushover' as const;
+  sensitiveFields = ['userKey', 'appToken'];
+  metadata: ProviderMetadata = {
+    type: 'pushover',
+    displayName: 'Pushover',
+    description: 'Send notifications via Pushover API',
+    iconLabel: 'P',
+    iconColor: 'bg-blue-500',
+    configFields: [
+      { name: 'userKey', label: 'User Key', type: 'text', required: true, placeholder: 'Your Pushover user key' },
+      { name: 'appToken', label: 'App Token', type: 'text', required: true, placeholder: 'Your Pushover app token' },
+      { name: 'device', label: 'Device', type: 'text', required: false, placeholder: 'Optional device name' },
+      {
+        name: 'priority', label: 'Priority', type: 'select', required: false, defaultValue: 0,
+        options: [
+          { label: 'Lowest', value: -2 },
+          { label: 'Low', value: -1 },
+          { label: 'Normal', value: 0 },
+          { label: 'High', value: 1 },
+          { label: 'Emergency', value: 2 },
+        ],
+      },
+    ],
+  };
+
+  async send(config: Record<string, any>, payload: NotificationPayload): Promise<void> {
+    const pushoverConfig = config as unknown as PushoverConfig;
+    const { title, message } = this.formatMessage(payload);
+
+    const body = new URLSearchParams({
+      token: pushoverConfig.appToken,
+      user: pushoverConfig.userKey,
+      title,
+      message,
+      priority: String(pushoverConfig.priority ?? PUSHOVER_PRIORITIES[payload.event]),
+      ...(pushoverConfig.device && { device: pushoverConfig.device }),
+    });
+
+    const response = await fetch('https://api.pushover.net/1/messages.json', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+      body: body.toString(),
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => 'Unknown error');
+      throw new Error(`Pushover API failed: ${response.status} ${errorText}`);
+    }
+
+    const result = await response.json();
+    if (result.status !== 1) {
+      throw new Error(`Pushover API error: ${JSON.stringify(result.errors || 'Unknown error')}`);
+    }
+  }
+
+  private formatMessage(payload: NotificationPayload): { title: string; message: string } {
+    const { event, title, author, userName, message } = payload;
+
+    let eventTitle = '';
+    let eventEmoji = '';
+
+    switch (event) {
+      case 'request_pending_approval':
+        eventTitle = 'New Request Pending Approval';
+        eventEmoji = '📬';
+        break;
+      case 'request_approved':
+        eventTitle = 'Request Approved';
+        eventEmoji = '✅';
+        break;
+      case 'request_available':
+        eventTitle = 'Audiobook Available';
+        eventEmoji = '🎉';
+        break;
+      case 'request_error':
+        eventTitle = 'Request Error';
+        eventEmoji = '❌';
+        break;
+    }
+
+    const messageLines = [
+      `${eventEmoji} ${eventTitle}`,
+      '',
+      `📚 ${title}`,
+      `✍️ ${author}`,
+      `👤 Requested by: ${userName}`,
+    ];
+
+    if (message) {
+      messageLines.push('', `⚠️ Error: ${message}`);
+    }
+
+    return {
+      title: eventTitle,
+      message: messageLines.join('\n'),
+    };
+  }
+}