feat(webhook): add Apprise webhook support and rename bot-webhook to discord-webhook

- Rename the Discord webhook endpoint from `/bot-webhook/` to `/discord-webhook/` for better clarity. - Add new routes and controller methods (`receiveApprise`, `receiveAppriseNotify`) to support Apprise integrations. - Implement `mapApprisePayload` in TalkService to map Apprise JSON format (title, body, type, attachments) to Talk message format. - Update the settings UI to generate and display URLs for both Discord and Apprise webhooks. - Update `INSTALL.md` and `README.md` documentation to reflect the new webhook paths and Apprise support. - Refactor token revocation logic to revoke all tokens for a room at once.
2026-06-12 16:40:53 -07:00
parent 6453715bf0
commit 42fa70491d
6 changed files with 411 additions and 52 deletions
@@ -44,7 +44,7 @@ class WebhookController extends Controller {
    /**
     * Receive Discord webhook payload for a room.
     *
-     * URL: POST /apps/ncdiscordhook/bot-webhook/{roomToken}/{token}
+     * URL: POST /apps/ncdiscordhook/discord-webhook/{roomToken}/{token}
     */
    #[PublicPage]
    #[NoCSRFRequired]
@@ -153,6 +153,143 @@ class WebhookController extends Controller {
        );
    }

+    /**
+     * Receive Apprise webhook payload for a room.
+     *
+     * URL: POST /apps/ncdiscordhook/apprise-webhook/{roomToken}/{token}
+     * Also handles Apprise's notify URL format: /apprise-webhook/{roomToken}/notify/{token}
+     *
+     * Apprise sends JSON like:
+     * {
+     *   "version": 0,
+     *   "type": "info|success|warning|error",
+     *   "title": "Title",
+     *   "body": "Message body",
+     *   "attachments": [{"path": "file:///path/to/file", "name": "file.png"}]
+     * }
+     */
+    #[PublicPage]
+    #[NoCSRFRequired]
+    public function receiveApprise(string $roomToken, string $token): DataResponse {
+        // Validate auth token
+        if (!$this->talkService->validateAuthToken($roomToken, $token)) {
+            $this->logger->warning('NCdiscordhook: invalid auth token for room', [
+                'app' => 'ncdiscordhook',
+                'room_token' => $roomToken,
+            ]);
+            return new DataResponse(
+                ['error' => 'Unauthorized'],
+                Http::STATUS_UNAUTHORIZED,
+                ['X-Webhook-Status' => 'unauthorized'],
+            );
+        }
+
+        // Parse payload — Apprise API sends {"version": 0, "notifications": [...]}
+        // while direct webhook may send form-encoded or flat JSON
+        $body = file_get_contents('php://input');
+        $contentType = $_SERVER['CONTENT_TYPE'] ?? '';
+
+        // Try JSON first
+        $data = @json_decode($body, true);
+        $jsonOk = json_last_error() === JSON_ERROR_NONE && is_array($data);
+
+        if (!$jsonOk) {
+            // Check if content-type indicates multipart form data
+            if (stripos($contentType, 'multipart/form-data') !== false) {
+                // PHP auto-parses multipart into $_POST
+                if (!empty($_POST)) {
+                    $data = $_POST;
+                }
+            } elseif (!empty($_POST)) {
+                // Some content-types still get auto-parsed
+                $data = $_POST;
+            } else {
+                // Fallback: try form-encoded
+                parse_str($body, $parsed);
+                if (!empty($parsed)) {
+                    $data = $parsed;
+                }
+            }
+        }
+
+        if (empty($data) || !is_array($data)) {
+            $this->logger->warning('NCdiscordhook: invalid payload from apprise webhook', [
+                'app' => 'ncdiscordhook',
+                'room_token' => $roomToken,
+                'content_type' => $contentType,
+                'body_length' => strlen($body),
+                'body_preview' => substr($body, 0, 1000),
+                'json_error' => $jsonOk ? null : json_last_error_msg(),
+                'post_empty' => empty($_POST) ? true : null,
+            ]);
+            return new DataResponse(
+                ['error' => 'Invalid payload'],
+                Http::STATUS_BAD_REQUEST,
+                ['X-Webhook-Status' => 'bad_request'],
+            );
+        }
+
+        // Apprise API wraps notifications in a "notifications" array
+        if (isset($data['notifications']) && is_array($data['notifications']) && !empty($data['notifications'])) {
+            $data = $data['notifications'][0];
+        }
+
+        // Map apprise format to our internal payload format
+        $mapped = $this->talkService->mapApprisePayload($data, $roomToken);
+
+        // Allow empty message for image-only notifications (type=image)
+        if ((empty($mapped['message']) || $mapped['message'] === '') && empty($mapped['richObjects'])) {
+            return new DataResponse(
+                ['error' => 'No message content'],
+                Http::STATUS_BAD_REQUEST,
+                ['X-Webhook-Status' => 'no_content'],
+            );
+        }
+
+        $senderName = $mapped['senderName'] ?? $this->talkService->getSenderNameDefault();
+        $richObjects = $mapped['richObjects'] ?? [];
+
+        // Post to Talk via Chat API
+        $success = $this->talkService->postToRoom($roomToken, $mapped['message'], $senderName, $richObjects);
+
+        if ($success) {
+            $this->logger->info('NCdiscordhook: apprise webhook processed successfully', [
+                'app' => 'ncdiscordhook',
+                'room_token' => $roomToken,
+            ]);
+            return new DataResponse(
+                ['status' => 'ok'],
+                Http::STATUS_CREATED,
+                ['X-Webhook-Status' => 'ok'],
+            );
+        }
+
+        $this->logger->error('NCdiscordhook: failed to post apprise message to Talk', [
+            'app' => 'ncdiscordhook',
+            'room_token' => $roomToken,
+        ]);
+        return new DataResponse(
+            ['error' => 'Failed to post to Talk'],
+            Http::STATUS_INTERNAL_SERVER_ERROR,
+            ['X-Webhook-Status' => 'error'],
+        );
+    }
+
+    /**
+     * Receive Apprise webhook payload for a room.
+     *
+     * Handles Apprise's notify URL format: /apprise-webhook/{roomToken}/notify/{token}
+     * Apprise's apprise:// URL scheme inserts 'notify' in the path.
+     * Delegates to receiveApprise() for processing.
+     *
+     * URL: POST /apps/ncdiscordhook/apprise-webhook/{roomToken}/notify/{token}
+     */
+    #[PublicPage]
+    #[NoCSRFRequired]
+    public function receiveAppriseNotify(string $roomToken, string $token): DataResponse {
+        return $this->receiveApprise($roomToken, $token);
+    }
+
    /**
     * Save bot password from the settings UI.
     *
@@ -216,7 +353,7 @@ class WebhookController extends Controller {
     *
     * URL: GET /apps/ncdiscordhook/debug
     * Query params:
-     *   - webhook_url: Full webhook URL to diagnose (e.g. /apps/ncdiscordhook/bot-webhook/{room}/{token})
+     *   - webhook_url: Full webhook URL to diagnose (e.g. /apps/ncdiscordhook/discord-webhook/{room}/{token})
     *   - test_post=1: Actually POST a test message to the room
     */
    #[PublicPage]
@@ -372,8 +509,8 @@ class WebhookController extends Controller {
        $path = $parsed['path'] ?? '';
        $segments = explode('/', trim($path, '/'));

-        // Expected: apps/ncdiscordhook/bot-webhook/{roomToken}/{token}
-        if (count($segments) >= 5 && $segments[0] === 'apps' && $segments[1] === 'ncdiscordhook' && $segments[2] === 'bot-webhook') {
+        // Expected: apps/ncdiscordhook/discord-webhook/{roomToken}/{token}
+        if (count($segments) >= 5 && $segments[0] === 'apps' && $segments[1] === 'ncdiscordhook' && $segments[2] === 'discord-webhook') {
            $roomToken = $segments[3];
            $token = $segments[4];
            $result['room_token'] = $roomToken;
@@ -525,7 +662,7 @@ class WebhookController extends Controller {

        } else {
            $result['url_valid'] = false;
-            $result['parse_error'] = 'URL does not match expected pattern: /apps/ncdiscordhook/bot-webhook/{roomToken}/{token}';
+            $result['parse_error'] = 'URL does not match expected pattern: /apps/ncdiscordhook/discord-webhook/{roomToken}/{token}';
        }

        return $result;
@@ -542,7 +679,7 @@ class WebhookController extends Controller {
        $path = $parsed['path'] ?? '';
        $segments = explode('/', trim($path, '/'));

-        if (!(count($segments) >= 5 && $segments[0] === 'apps' && $segments[1] === 'ncdiscordhook' && $segments[2] === 'bot-webhook')) {
+        if (!(count($segments) >= 5 && $segments[0] === 'apps' && $segments[1] === 'ncdiscordhook' && $segments[2] === 'discord-webhook')) {
            return ['error' => 'Invalid webhook URL format'];
        }

@@ -566,6 +566,144 @@ class TalkService {
        return $this->config->getAppValue(self::APP_ID, 'sender_name', 'Webhook Bot');
    }

+    /**
+     * Map Apprise JSON payload to our internal format.
+     *
+     * Apprise sends: { version, type, title, body, attachments }
+     * Returns: { message, senderName, richObjects }
+     */
+    public function mapApprisePayload(array $data, string $roomToken = ''): array {
+        $parts = [];
+
+        // Title (if present)
+        if (!empty($data['title'])) {
+            $parts[] = '**' . $data['title'] . '**';
+        }
+
+        // Body
+        if (!empty($data['body'])) {
+            $parts[] = $data['body'];
+        }
+
+        // For image-type notifications, use the attachment URL as the message
+        if (!empty($data['type']) && $data['type'] === 'image') {
+            // Apprise sends image notifications with type=image and attachment (string URL)
+            $imageUrls = [];
+            if (!empty($data['attachment']) && is_string($data['attachment'])) {
+                $imageUrls[] = $data['attachment'];
+            }
+            if (!empty($data['attachments']) && is_array($data['attachments'])) {
+                foreach ($data['attachments'] as $a) {
+                    if (is_string($a)) {
+                        $imageUrls[] = $a;
+                    } elseif (is_array($a) && !empty($a['url'])) {
+                        $imageUrls[] = $a['url'];
+                    }
+                }
+            }
+            if (!empty($imageUrls)) {
+                // Use title as message if body is empty
+                if (empty($data['body'])) {
+                    $message = !empty($data['title']) ? '**' . $data['title'] . '**' : '';
+                } else {
+                    $message = implode("\n\n", $parts);
+                }
+                $senderName = $this->config->getAppValue(self::APP_ID, 'sender_name', 'Webhook Bot');
+                $richObjects = [];
+                foreach ($imageUrls as $imageUrl) {
+                    $imageData = $this->downloadImage($imageUrl);
+                    if ($imageData === null) {
+                        continue;
+                    }
+                    $fileName = basename(parse_url($imageUrl, PHP_URL_PATH)) ?: 'attachment';
+                    $uploadPath = $this->uploadImage($roomToken, $fileName, $imageData['data'], $imageData['mimeType']);
+                    if ($uploadPath !== null) {
+                        $richObj = $this->buildRichObject($uploadPath, $imageData['mimeType'], $roomToken);
+                        if ($richObj !== null) {
+                            $richObjects[] = $richObj;
+                        }
+                    }
+                }
+                return [
+                    'message' => $message,
+                    'senderName' => $senderName,
+                    'richObjects' => $richObjects,
+                ];
+            }
+        }
+
+        // Type prefix for context (e.g. "[Warning]")
+        if (!empty($data['type'])) {
+            $typeLabels = [
+                'info' => '[Info]',
+                'success' => '[Success]',
+                'warning' => '[Warning]',
+                'error' => '[Error]',
+            ];
+            if (isset($typeLabels[$data['type']])) {
+                array_unshift($parts, $typeLabels[$data['type']]);
+            }
+        }
+
+        $message = implode("\n\n", $parts);
+
+        // Sender name: use app name if available, otherwise default
+        $senderName = $this->config->getAppValue(self::APP_ID, 'sender_name', 'Webhook Bot');
+
+        // Handle attachments: download files and upload to Talk
+        $richObjects = [];
+        if (!empty($data['attachments']) && is_array($data['attachments'])) {
+            foreach ($data['attachments'] as $attachment) {
+                if (!is_array($attachment)) {
+                    continue;
+                }
+
+                $filePath = $attachment['path'] ?? '';
+                if (str_starts_with($filePath, 'file://')) {
+                    $localPath = substr($filePath, 7); // Strip 'file://' prefix
+                    if (is_file($localPath) && is_readable($localPath)) {
+                        $fileData = file_get_contents($localPath);
+                        if ($fileData === false) {
+                            continue;
+                        }
+
+                        $fileName = $attachment['name'] ?? basename($localPath);
+                        $mimeType = $attachment['mimeType'] ?? mime_content_type($localPath);
+
+                        $uploadPath = $this->uploadImage($roomToken, $fileName, $fileData, $mimeType);
+                        if ($uploadPath !== null) {
+                            $richObj = $this->buildRichObject($uploadPath, $mimeType, $roomToken);
+                            if ($richObj !== null) {
+                                $richObjects[] = $richObj;
+                            }
+                        }
+                    }
+                } elseif (!empty($attachment['url'] ?? '')) {
+                    // Remote URL attachment
+                    $imageData = $this->downloadImage($attachment['url']);
+                    if ($imageData === null) {
+                        continue;
+                    }
+
+                    $fileName = $attachment['name'] ?? 'attachment';
+                    $uploadPath = $this->uploadImage($roomToken, $fileName, $imageData['data'], $imageData['mimeType']);
+                    if ($uploadPath !== null) {
+                        $richObj = $this->buildRichObject($uploadPath, $imageData['mimeType'], $roomToken);
+                        if ($richObj !== null) {
+                            $richObjects[] = $richObj;
+                        }
+                    }
+                }
+            }
+        }
+
+        return [
+            'message' => $message,
+            'senderName' => $senderName,
+            'richObjects' => $richObjects,
+        ];
+    }
+
    /**
     * Set sender name default.
     */