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-06-03 21:00:09 +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,91 @@
+/**
+ * Component: Discord Notification Provider
+ * Documentation: documentation/backend/services/notifications.md
+ */
+
+import { INotificationProvider, NotificationPayload, ProviderMetadata } from '../INotificationProvider';
+
+export interface DiscordConfig {
+  webhookUrl: string;
+  username?: string;
+  avatarUrl?: string;
+}
+
+// Discord embed colors by event type
+const DISCORD_COLORS = {
+  request_pending_approval: 0xfbbf24, // yellow-400
+  request_approved: 0x22c55e, // green-500
+  request_available: 0x3b82f6, // blue-500
+  request_error: 0xef4444, // red-500
+};
+
+// Discord embed titles
+const DISCORD_TITLES = {
+  request_pending_approval: '📬 New Request Pending Approval',
+  request_approved: '✅ Request Approved',
+  request_available: '🎉 Audiobook Available',
+  request_error: '❌ Request Error',
+};
+
+export class DiscordProvider implements INotificationProvider {
+  type = 'discord' as const;
+  sensitiveFields = ['webhookUrl'];
+  metadata: ProviderMetadata = {
+    type: 'discord',
+    displayName: 'Discord',
+    description: 'Send notifications via Discord webhook',
+    iconLabel: 'D',
+    iconColor: 'bg-indigo-500',
+    configFields: [
+      { name: 'webhookUrl', label: 'Webhook URL', type: 'text', required: true, placeholder: 'https://discord.com/api/webhooks/...' },
+      { name: 'username', label: 'Username', type: 'text', required: false, placeholder: 'ReadMeABook', defaultValue: 'ReadMeABook' },
+      { name: 'avatarUrl', label: 'Avatar URL', type: 'text', required: false, placeholder: 'https://example.com/avatar.png', defaultValue: '' },
+    ],
+  };
+
+  async send(config: Record<string, any>, payload: NotificationPayload): Promise<void> {
+    const discordConfig = config as unknown as DiscordConfig;
+    const embed = this.formatEmbed(payload);
+
+    const body = {
+      username: discordConfig.username || 'ReadMeABook',
+      avatar_url: discordConfig.avatarUrl,
+      embeds: [embed],
+    };
+
+    const response = await fetch(discordConfig.webhookUrl, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body),
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => 'Unknown error');
+      throw new Error(`Discord webhook failed: ${response.status} ${errorText}`);
+    }
+  }
+
+  private formatEmbed(payload: NotificationPayload): any {
+    const { event, title, author, userName, message, requestId, timestamp } = payload;
+
+    const fields = [
+      { name: 'Title', value: title, inline: false },
+      { name: 'Author', value: author, inline: true },
+      { name: 'Requested By', value: userName, inline: true },
+    ];
+
+    if (message) {
+      fields.push({ name: 'Error', value: message, inline: false });
+    }
+
+    return {
+      title: DISCORD_TITLES[event],
+      color: DISCORD_COLORS[event],
+      fields,
+      footer: {
+        text: `Request ID: ${requestId}`,
+      },
+      timestamp: timestamp.toISOString(),
+    };
+  }
+}