Implement 'remove' method and refactor 'upload' for 'Uploadable' objects

This commit implements a 'remove' method for 'Uploadable' objects and refactors the existing 'upload' method in 'AbstractApplication' and 'Listener' classes. It also creates a new 'getApiEndpoint' method to efficiently retrieve API endpoint paths. 'root

src/Abstract/AbstractApplication.php

@@ -437,8 +437,16 @@ public function toJson(): string|false
     public function upload(UnitRequest $request): void
     {
         $request->setMethod('PUT')
-            ->send("/config/applications/{$this->getName()}", true, [
-                'json' => array_filter($this->toArray(), fn ($item) => !empty($item))
-            ]);
+            ->send($this->getApiEndpoint(), true, ['json' => array_filter($this->toArray(), fn ($item) => !empty($item))]);
+    }
+
+    public function remove(UnitRequest $request): void
+    {
+        $request->setMethod('DELETE')->send($this->getApiEndpoint());
+    }
+
+    public function getApiEndpoint(): string
+    {
+        return "/config/applications/{$this->getName()}";
     }
 }

src/Config/Application/PhpApplication.php

@@ -135,11 +135,11 @@ final public function parseFromArray(array $data): void
     {
         parent::parseFromArray($data);
 
-        if (!is_string($data['root'])) {
-            throw new \InvalidArgumentException('root must be a string');
-        }
-
         if (array_key_exists('root', $data)) {
+            if (!is_string($data['root'])) {
+                throw new \InvalidArgumentException('root must be a string');
+            }
+
             $this->setRoot($data['root']);
         }
 

src/Config/Listener.php

@@ -229,9 +229,19 @@ public function toUnitArray()
 
     #[\Override] public function upload(UnitRequest $request): void
     {
-        $request->setMethod('PUT')
-            ->send("/config/listeners/{$this->getListener()}", true, [
-                'body' => $this->toJson()
-            ]);
+        $request->setMethod('PUT')->send($this->getApiEndpoint(), true, ['json' => $this->toArray()]);
+    }
+
+    /**
+     * @throws UnitException
+     */
+    public function remove(UnitRequest $request): void
+    {
+        $request->setMethod('DELETE')->send($this->getApiEndpoint());
+    }
+
+    private function getApiEndpoint(): string
+    {
+        return "/config/listeners/{$this->getListener()}";
     }
 }

src/Contracts/Uploadable.php

@@ -6,5 +6,19 @@
 
 interface Uploadable
 {
+    /**
+     * Uploads a file using the specified UnitRequest object.
+     *
+     * @param UnitRequest $request The UnitRequest object containing the file to be uploaded.
+     * @return mixed Returns the result of the upload process.
+     */
     public function upload(UnitRequest $request);
+
+    /**
+     * Removes the specified unit.
+     *
+     * @param UnitRequest $request The request object containing the details of the unit to be removed.
+     * @return mixed The result of the removal operation.
+     */
+    public function remove(UnitRequest $request);
 }

src/Unit.php

@@ -240,8 +240,25 @@ public function removeConfig(): bool
         return true;
     }
 
+    /**
+     * Uploads the specified Uploadable object.
+     *
+     * @param Uploadable $object
+     */
     public function upload(Uploadable $object): void
     {
         $object->upload($this->request);
     }
+
+    /**
+     * Removes an Uploadable object.
+     *
+     * @param Uploadable $object The Uploadable object to be removed.
+     *
+     * @return void
+     */
+    public function remove(Uploadable $object): void
+    {
+        $object->remove($this->request);
+    }
 }