Add base code to support retrieving allocations as a client

Author: DaneEveritt

app/Http/Controllers/Api/Client/Servers/NetworkController.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace Pterodactyl\Http\Controllers\Api\Client\Servers;
+
+use Pterodactyl\Models\Server;
+use Pterodactyl\Transformers\Api\Client\AllocationTransformer;
+use Pterodactyl\Http\Controllers\Api\Client\ClientApiController;
+use Pterodactyl\Contracts\Repository\AllocationRepositoryInterface;
+use Pterodactyl\Http\Requests\Api\Client\Servers\Network\GetNetworkRequest;
+
+class NetworkController extends ClientApiController
+{
+    /**
+     * @var \Pterodactyl\Contracts\Repository\AllocationRepositoryInterface
+     */
+    private $repository;
+
+    /**
+     * NetworkController constructor.
+     *
+     * @param \Pterodactyl\Contracts\Repository\AllocationRepositoryInterface $repository
+     */
+    public function __construct(AllocationRepositoryInterface $repository)
+    {
+        parent::__construct();
+
+        $this->repository = $repository;
+    }
+
+    /**
+     * Lists all of the allocations available to a server and wether or
+     * not they are currently assigned as the primary for this server.
+     *
+     * @param \Pterodactyl\Http\Requests\Api\Client\Servers\Network\GetNetworkRequest $request
+     * @return array
+     */
+    public function index(GetNetworkRequest $request): array
+    {
+        $server = $request->getModel(Server::class);
+
+        $allocations = $this->repository->findWhere([
+            ['server_id', '=', $server->id],
+        ]);
+
+        return $this->fractal->collection($allocations)
+            ->transformWith($this->getTransformer(AllocationTransformer::class))
+            ->toArray();
+    }
+}

app/Http/Requests/Api/Client/Servers/Network/GetNetworkRequest.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Pterodactyl\Http\Requests\Api\Client\Servers\Network;
+
+use Pterodactyl\Models\Server;
+use Pterodactyl\Http\Requests\Api\Client\ClientApiRequest;
+
+class GetNetworkRequest extends ClientApiRequest
+{
+    /**
+     * Check that the user has permission to view the allocations for
+     * this server.
+     *
+     * @return bool
+     */
+    public function authorize(): bool
+    {
+        return $this->user()->can('view-allocations', $this->getModel(Server::class));
+    }
+}

app/Transformers/Api/Client/AllocationTransformer.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Pterodactyl\Transformers\Api\Client;
+
+use Pterodactyl\Models\Allocation;
+
+class AllocationTransformer extends BaseClientTransformer
+{
+    /**
+     * Return the resource name for the JSONAPI output.
+     *
+     * @return string
+     */
+    public function getResourceName(): string
+    {
+        return 'allocation';
+    }
+
+    /**
+     * Return basic information about the currently logged in user.
+     *
+     * @param \Pterodactyl\Models\Allocation $model
+     * @return array
+     */
+    public function transform(Allocation $model)
+    {
+        $model->loadMissing('server');
+
+        return [
+            'ip' => $model->ip,
+            'alias' => $model->ip_alias,
+            'port' => $model->port,
+            'default' => $model->getRelation('server')->allocation_id === $model->id,
+        ];
+    }
+}

routes/api-client.php

@@ -46,4 +46,8 @@
             ->where('file', '.*')
             ->name('api.client.servers.files.download');
     });
+
+    Route::group(['prefix' => '/network'], function () {
+        Route::get('/', 'Servers\NetworkController@index')->name('api.client.servers.network');
+    });
 });