From 45e75edf0544217e1a46f5628037770a6713b23b Mon Sep 17 00:00:00 2001
From: Dan Brown <ssddanbrown@googlemail.com>
Date: Wed, 19 Jul 2023 11:03:05 +0100
Subject: [PATCH] Notifications: Started activity->notification core framework

---
 .../Handlers/CommentCreationNotificationHandler.php | 13 +++++++++++++
 .../Notifications/Handlers/NotificationHandler.php  | 13 +++++++++++++
 .../Handlers/PageCreationNotificationHandler.php    | 13 +++++++++++++
 .../Handlers/PageUpdateNotificationHandler.php      | 13 +++++++++++++
 app/Activity/Tools/ActivityLogger.php               | 11 +++++++++--
 5 files changed, 61 insertions(+), 2 deletions(-)
 create mode 100644 app/Activity/Notifications/Handlers/CommentCreationNotificationHandler.php
 create mode 100644 app/Activity/Notifications/Handlers/NotificationHandler.php
 create mode 100644 app/Activity/Notifications/Handlers/PageCreationNotificationHandler.php
 create mode 100644 app/Activity/Notifications/Handlers/PageUpdateNotificationHandler.php

diff --git a/app/Activity/Notifications/Handlers/CommentCreationNotificationHandler.php b/app/Activity/Notifications/Handlers/CommentCreationNotificationHandler.php
new file mode 100644
index 000000000..5f2e1c770
--- /dev/null
+++ b/app/Activity/Notifications/Handlers/CommentCreationNotificationHandler.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace BookStack\Activity\Notifications\Handlers;
+
+use BookStack\Activity\Models\Loggable;
+
+class CommentCreationNotificationHandler implements NotificationHandler
+{
+    public function handle(string $activityType, Loggable|string $detail): void
+    {
+        // TODO
+    }
+}
diff --git a/app/Activity/Notifications/Handlers/NotificationHandler.php b/app/Activity/Notifications/Handlers/NotificationHandler.php
new file mode 100644
index 000000000..fdf97eb79
--- /dev/null
+++ b/app/Activity/Notifications/Handlers/NotificationHandler.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace BookStack\Activity\Notifications\Handlers;
+
+use BookStack\Activity\Models\Loggable;
+
+interface NotificationHandler
+{
+    /**
+     * Run this handler.
+     */
+    public function handle(string $activityType, string|Loggable $detail): void;
+}
diff --git a/app/Activity/Notifications/Handlers/PageCreationNotificationHandler.php b/app/Activity/Notifications/Handlers/PageCreationNotificationHandler.php
new file mode 100644
index 000000000..20189fc1e
--- /dev/null
+++ b/app/Activity/Notifications/Handlers/PageCreationNotificationHandler.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace BookStack\Activity\Notifications\Handlers;
+
+use BookStack\Activity\Models\Loggable;
+
+class PageCreationNotificationHandler implements NotificationHandler
+{
+    public function handle(string $activityType, Loggable|string $detail): void
+    {
+        // TODO
+    }
+}
diff --git a/app/Activity/Notifications/Handlers/PageUpdateNotificationHandler.php b/app/Activity/Notifications/Handlers/PageUpdateNotificationHandler.php
new file mode 100644
index 000000000..ef71dccbf
--- /dev/null
+++ b/app/Activity/Notifications/Handlers/PageUpdateNotificationHandler.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace BookStack\Activity\Notifications\Handlers;
+
+use BookStack\Activity\Models\Loggable;
+
+class PageUpdateNotificationHandler implements NotificationHandler
+{
+    public function handle(string $activityType, Loggable|string $detail): void
+    {
+        // TODO
+    }
+}
diff --git a/app/Activity/Tools/ActivityLogger.php b/app/Activity/Tools/ActivityLogger.php
index 315e8bfdf..3135f57a7 100644
--- a/app/Activity/Tools/ActivityLogger.php
+++ b/app/Activity/Tools/ActivityLogger.php
@@ -6,7 +6,7 @@ use BookStack\Activity\DispatchWebhookJob;
 use BookStack\Activity\Models\Activity;
 use BookStack\Activity\Models\Loggable;
 use BookStack\Activity\Models\Webhook;
-use BookStack\App\Model;
+use BookStack\Activity\Notifications\NotificationManager;
 use BookStack\Entities\Models\Entity;
 use BookStack\Facades\Theme;
 use BookStack\Theming\ThemeEvents;
@@ -15,10 +15,16 @@ use Illuminate\Support\Facades\Log;
 
 class ActivityLogger
 {
+    public function __construct(
+        protected NotificationManager $notifications
+    ) {
+        $this->notifications->loadDefaultHandlers();
+    }
+
     /**
      * Add a generic activity event to the database.
      */
-    public function add(string $type, $detail = '')
+    public function add(string $type, string|Loggable $detail = ''): void
     {
         $detailToStore = ($detail instanceof Loggable) ? $detail->logDescriptor() : $detail;
 
@@ -34,6 +40,7 @@ class ActivityLogger
 
         $this->setNotification($type);
         $this->dispatchWebhooks($type, $detail);
+        $this->notifications->handle($type, $detail);
         Theme::dispatch(ThemeEvents::ACTIVITY_LOGGED, $type, $detail);
     }