Update repository base code to be cleaner and make use of PHP 7 features

app/Contracts/Repository/NodeRepositoryInterface.php

@@ -1,68 +1,65 @@
 <?php
-/**
- * Pterodactyl - Panel
- * Copyright (c) 2015 - 2017 Dane Everitt <dane@daneeveritt.com>.
- *
- * This software is licensed under the terms of the MIT license.
- * https://opensource.org/licenses/MIT
- */
 
 namespace Pterodactyl\Contracts\Repository;
 
+use Pterodactyl\Models\Node;
+use Illuminate\Support\Collection;
+use Illuminate\Contracts\Pagination\LengthAwarePaginator;
 use Pterodactyl\Contracts\Repository\Attributes\SearchableInterface;
 
 interface NodeRepositoryInterface extends RepositoryInterface, SearchableInterface
 {
+    const THRESHOLD_PERCENTAGE_LOW = 75;
+    const THRESHOLD_PERCENTAGE_MEDIUM = 90;
+
     /**
      * Return the usage stats for a single node.
      *
-     * @param int $id
+     * @param \Pterodactyl\Models\Node $node
      * @return array
      */
-    public function getUsageStats($id);
+    public function getUsageStats(Node $node): array;
 
     /**
      * Return all available nodes with a searchable interface.
      *
-     * @param int $count
      * @return \Illuminate\Contracts\Pagination\LengthAwarePaginator
      */
-    public function getNodeListingData($count = 25);
+    public function getNodeListingData(): LengthAwarePaginator;
 
     /**
      * Return a single node with location and server information.
      *
-     * @param int $id
-     * @return mixed
-     *
-     * @throws \Pterodactyl\Exceptions\Repository\RecordNotFoundException
+     * @param \Pterodactyl\Models\Node $node
+     * @param bool                     $refresh
+     * @return \Pterodactyl\Models\Node
      */
-    public function getSingleNode($id);
+    public function loadLocationAndServerCount(Node $node, bool $refresh = false): Node;
 
     /**
-     * Return a node with all of the associated allocations and servers that are attached to said allocations.
+     * Attach a paginated set of allocations to a node mode including
+     * any servers that are also attached to those allocations.
      *
-     * @param int $id
-     * @return mixed
-     *
-     * @throws \Pterodactyl\Exceptions\Repository\RecordNotFoundException
+     * @param \Pterodactyl\Models\Node $node
+     * @param bool                     $refresh
+     * @return \Pterodactyl\Models\Node
      */
-    public function getNodeAllocations($id);
+    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 mixed
+     * @return \Pterodactyl\Models\Node
      *
      * @throws \Pterodactyl\Exceptions\Repository\RecordNotFoundException
      */
-    public function getNodeServers($id);
+    public function getNodeServers(int $id): Node;
 
     /**
      * Return a collection of nodes for all locations to use in server creation UI.
      *
-     * @return mixed
+     * @return \Illuminate\Support\Collection
      */
-    public function getNodesForServerCreation();
+    public function getNodesForServerCreation(): Collection;
 }