From 7ce59fec15d88f56f90de983467b2844b26bcd9c Mon Sep 17 00:00:00 2001
From: netkas <netkas.nosial@gmail.com>
Date: Fri, 6 Jun 2025 18:02:47 -0400
Subject: [PATCH] Add BlacklistEntity class to handle entity blacklisting
 requests

---
 .../Methods/Blacklist/BlacklistEntity.php     | 88 +++++++++++++++++++
 1 file changed, 88 insertions(+)
 create mode 100644 src/FederationServer/Methods/Blacklist/BlacklistEntity.php

diff --git a/src/FederationServer/Methods/Blacklist/BlacklistEntity.php b/src/FederationServer/Methods/Blacklist/BlacklistEntity.php
new file mode 100644
index 0000000..2f507d7
--- /dev/null
+++ b/src/FederationServer/Methods/Blacklist/BlacklistEntity.php
@@ -0,0 +1,88 @@
+<?php
+
+    namespace FederationServer\Methods\Blacklist;
+
+    use FederationServer\Classes\Configuration;
+    use FederationServer\Classes\Enums\BlacklistType;
+    use FederationServer\Classes\Managers\BlacklistManager;
+    use FederationServer\Classes\Managers\EntitiesManager;
+    use FederationServer\Classes\RequestHandler;
+    use FederationServer\Classes\Validate;
+    use FederationServer\Exceptions\DatabaseOperationException;
+    use FederationServer\Exceptions\RequestException;
+    use FederationServer\FederationServer;
+
+    class BlacklistEntity extends RequestHandler
+    {
+        /**
+         * @inheritDoc
+         */
+        public static function handleRequest(): void
+        {
+            // Get the authenticated operator
+            $authenticatedOperator = FederationServer::requireAuthenticatedOperator();
+            if(!$authenticatedOperator->canManageBlacklist())
+            {
+                throw new RequestException('Insufficient permissions to manage the blacklist', 401);
+            }
+
+            $entityUuid = FederationServer::getParameter('entity');
+            $type = BlacklistType::tryFrom(FederationServer::getParameter('type'));
+            $expires = FederationServer::getParameter('expires');
+            $evidence = FederationServer::getParameter('evidence');
+
+            if($entityUuid === null || !Validate::uuid($entityUuid))
+            {
+                throw new RequestException('A valid entity UUID is required', 400);
+            }
+
+            if($type === null)
+            {
+                throw new RequestException('A valid blacklist type is required', 400);
+            }
+
+            if($expires !== null)
+            {
+                if((int)$expires < time())
+                {
+                    throw new RequestException('The expiration time must be in the future', 400);
+                }
+                if((int)$expires < (time() + Configuration::getServerConfiguration()->getListBlacklistMaxItems()))
+                {
+                    throw new RequestException('The expiration time must be at least ' . Configuration::getServerConfiguration()->getListBlacklistMaxItems() . ' seconds in the future', 400);
+                }
+            }
+
+            if($evidence !== null && !Validate::uuid($evidence))
+            {
+                throw new RequestException('Evidence must be a valid UUID', 400);
+            }
+
+            try
+            {
+                if(!EntitiesManager::entityExistsByUuid($entityUuid))
+                {
+                    throw new RequestException('Entity not found', 404);
+                }
+
+                if($evidence !== null && !EntitiesManager::entityExistsByUuid($evidence))
+                {
+                    throw new RequestException('Evidence entity not found', 404);
+                }
+
+                $blacklistUuid = BlacklistManager::blacklistEntity(
+                    entity: $entityUuid,
+                    operator: $authenticatedOperator->getUuid(),
+                    type: $type,
+                    expires: $expires,
+                    evidence: $evidence
+                );
+            }
+            catch(DatabaseOperationException $e)
+            {
+                throw new RequestException('Failed to blacklist entity', 500, $e);
+            }
+
+            self::successResponse($blacklistUuid);
+        }
+    }
\ No newline at end of file