Add CreateOperator class to handle operator creation and logging

src/FederationServer/Methods/CreateOperator.php

@@ -0,0 +1,53 @@
+<?php
+
+    namespace FederationServer\Methods;
+
+    use FederationServer\Classes\Enums\AuditLogType;
+    use FederationServer\Classes\Logger;
+    use FederationServer\Classes\Managers\AuditLogManager;
+    use FederationServer\Classes\Managers\OperatorManager;
+    use FederationServer\Classes\RequestHandler;
+    use FederationServer\Exceptions\DatabaseOperationException;
+    use FederationServer\Exceptions\RequestException;
+    use FederationServer\FederationServer;
+
+    class CreateOperator extends RequestHandler
+    {
+        /**
+         * @inheritDoc
+         */
+        public static function handleRequest(): void
+        {
+            $authenticatedOperator = FederationServer::getAuthenticatedOperator();
+
+            // Ensure the authenticated operator has permission to create new operators.
+            if(!$authenticatedOperator->canManageOperators())
+            {
+                throw new RequestException('Unauthorized: Insufficient permissions to create operators', 403);
+            }
+
+            if(!FederationServer::getParameter('name'))
+            {
+                throw new RequestException('Bad Request: Operator name is required', 400);
+            }
+
+            try
+            {
+                $operatorUuid = OperatorManager::createOperator(FederationServer::getParameter('name'));
+                AuditLogManager::createEntry(AuditLogType::OPERATOR_CREATED, sprintf('Operator %s (%s) created by %s (%s)',
+                    FederationServer::getParameter('name'),
+                    $operatorUuid,
+                    $authenticatedOperator->getName(),
+                    $authenticatedOperator->getUuid()
+                ), $authenticatedOperator->getUuid());
+            }
+            catch(DatabaseOperationException $e)
+            {
+                Logger::log()->error('Database error while creating operator: ' . $e->getMessage(), $e);
+                throw new RequestException('Internal Server Error: Unable to create operator', 500, $e);
+            }
+
+            // Respond with the UUID of the newly created operator.
+            self::successResponse($operatorUuid);
+        }
+    }