Merge branch 'develop' into feature/bulk-reinstall-command

app/Contracts/Http/ClientPermissionsRequest.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Pterodactyl\Contracts\Http;
+
+interface ClientPermissionsRequest
+{
+    /**
+     * Returns the permissions string indicating which permission should be used to
+     * validate that the authenticated user has permission to perform this action aganist
+     * the given resource (server).
+     *
+     * @return string
+     */
+    public function permission(): string;
+}

app/Contracts/Repository/Daemon/FileRepositoryInterface.php

@@ -13,19 +13,18 @@ interface FileRepositoryInterface extends BaseRepositoryInterface
      * @param string $path
      * @return \stdClass
      *
-     * @throws \GuzzleHttp\Exception\RequestException
+     * @throws \GuzzleHttp\Exception\TransferException
      */
     public function getFileStat(string $path): stdClass;
 
     /**
      * Return the contents of a given file if it can be edited in the Panel.
      *
-     * @param string $path
+     * @param string   $path
+     * @param int|null $notLargerThan
      * @return string
-     *
-     * @throws \GuzzleHttp\Exception\RequestException
      */
-    public function getContent(string $path): string;
+    public function getContent(string $path, int $notLargerThan = null): string;
 
     /**
      * Save new contents to a given file.
@@ -34,7 +33,7 @@ interface FileRepositoryInterface extends BaseRepositoryInterface
      * @param string $content
      * @return \Psr\Http\Message\ResponseInterface
      *
-     * @throws \GuzzleHttp\Exception\RequestException
+     * @throws \GuzzleHttp\Exception\TransferException
      */
     public function putContent(string $path, string $content): ResponseInterface;
 
@@ -44,7 +43,41 @@ interface FileRepositoryInterface extends BaseRepositoryInterface
      * @param string $path
      * @return array
      *
-     * @throws \GuzzleHttp\Exception\RequestException
+     * @throws \GuzzleHttp\Exception\TransferException
      */
     public function getDirectory(string $path): array;
+
+    /**
+     * Creates a new directory for the server in the given $path.
+     *
+     * @param string $name
+     * @param string $path
+     * @return \Psr\Http\Message\ResponseInterface
+     */
+    public function createDirectory(string $name, string $path): ResponseInterface;
+
+    /**
+     * Renames or moves a file on the remote machine.
+     *
+     * @param string $from
+     * @param string $to
+     * @return \Psr\Http\Message\ResponseInterface
+     */
+    public function renameFile(string $from, string $to): ResponseInterface;
+
+    /**
+     * Copy a given file and give it a unique name.
+     *
+     * @param string $location
+     * @return \Psr\Http\Message\ResponseInterface
+     */
+    public function copyFile(string $location): ResponseInterface;
+
+    /**
+     * Delete a file or folder for the server.
+     *
+     * @param string $location
+     * @return \Psr\Http\Message\ResponseInterface
+     */
+    public function deleteFile(string $location): ResponseInterface;
 }

app/Contracts/Repository/NodeRepositoryInterface.php

@@ -55,16 +55,6 @@ interface NodeRepositoryInterface extends RepositoryInterface, SearchableInterfa
      */
     public function loadNodeAllocations(Node $node, bool $refresh = false): Node;
 
-    /**
-     * Return a node with all of the servers attached to that node.
-     *
-     * @param int $id
-     * @return \Pterodactyl\Models\Node
-     *
-     * @throws \Pterodactyl\Exceptions\Repository\RecordNotFoundException
-     */
-    public function getNodeServers(int $id): Node;
-
     /**
      * Return a collection of nodes for all locations to use in server creation UI.
      *

app/Contracts/Repository/ServerRepositoryInterface.php

@@ -161,4 +161,14 @@ interface ServerRepositoryInterface extends RepositoryInterface, SearchableInter
      * @return int
      */
     public function getSuspendedServersCount(): int;
+
+    /**
+     * Returns all of the servers that exist for a given node in a paginated response.
+     *
+     * @param int $node
+     * @param int $limit
+     *
+     * @return \Illuminate\Contracts\Pagination\LengthAwarePaginator
+     */
+    public function loadAllServersForNode(int $node, int $limit): LengthAwarePaginator;
 }