Add all missing API endpoints and fix paths to match OpenAPI spec

Fixed paths:
- Power endpoints: boot/shutdown/restart/poweroff → power/*
- Package: POST change-package → PUT package/{id}
- Backup plan: POST backup-plan → PUT backups/plan/{id}
- Whitelist: whitelist → networkWhitelist
- IPv4 quantity: ipv4/quantity → ipv4Qty
- Traffic modify: traffic → modify/traffic
- Traffic blocks: traffic-blocks → traffic/blocks
- Hypervisor groups: hypervisor-groups → compute/hypervisors/groups

New server endpoints: suspend, unsuspend, resetPassword, customXML,
modifyName, modifyCpuCores, modifyCpuThrottle, modifyMemory,
changeOwner, traffic stats, templates, VNC, listServers, listByUser.

New resource builders: Hypervisors, Packages, Users, SSH Keys,
IP Blocks, Backups, DNS, Media, Queue, Self Service.

Added API_REFERENCE.md generated from OpenAPI spec.
95 tests, 286 assertions - all passing.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Prophet731

API_REFERENCE.md

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace EZScale\VirtFusion\Builders;
+
+use EZScale\VirtFusion\DataObjects\Backup;
+use EZScale\VirtFusion\HttpClient;
+
+class BackupsBuilder
+{
+    public function __construct(
+        private readonly HttpClient $http,
+    ) {
+    }
+
+    /**
+     * @return Backup[]
+     */
+    public function listByServer(int $serverId): array
+    {
+        $data = $this->http->request('GET', "backups/server/{$serverId}");
+
+        return array_map(
+            fn(array $item) => Backup::fromArray($item),
+            $data['data'] ?? [],
+        );
+    }
+}

src/Builders/BackupsBuilder.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace EZScale\VirtFusion\Builders;
+
+use EZScale\VirtFusion\HttpClient;
+
+class DnsBuilder
+{
+    public function __construct(
+        private readonly HttpClient $http,
+    ) {
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function getService(int $serviceId): array
+    {
+        $data = $this->http->request('GET', "dns/services/{$serviceId}");
+
+        return $data['data'] ?? $data;
+    }
+}

src/Builders/DnsBuilder.php

@@ -19,14 +19,14 @@ public function __construct(
 
     public function get(): HypervisorGroup
     {
-        $data = $this->http->request('GET', "hypervisor-groups/{$this->groupId}");
+        $data = $this->http->request('GET', "compute/hypervisors/groups/{$this->groupId}");
 
         return HypervisorGroup::fromArray($data['data'] ?? $data);
     }
 
     public function resources(int $page = 1): PaginatedResponse
     {
-        $data = $this->http->request('GET', "hypervisor-groups/{$this->groupId}/resources", [
+        $data = $this->http->request('GET', "compute/hypervisors/groups/{$this->groupId}/resources", [
             'query' => ['page' => $page],
         ]);
 

src/Builders/HypervisorGroupBuilder.php

@@ -17,7 +17,7 @@ public function __construct(
 
     public function list(int $page = 1): PaginatedResponse
     {
-        $data = $this->http->request('GET', 'hypervisor-groups', [
+        $data = $this->http->request('GET', 'compute/hypervisors/groups', [
             'query' => ['page' => $page],
         ]);
 

src/Builders/HypervisorGroupsBuilder.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace EZScale\VirtFusion\Builders;
+
+use EZScale\VirtFusion\DataObjects\Hypervisor;
+use EZScale\VirtFusion\DataObjects\PaginatedResponse;
+use EZScale\VirtFusion\HttpClient;
+
+class HypervisorsBuilder
+{
+    public function __construct(
+        private readonly HttpClient $http,
+    ) {
+    }
+
+    public function list(int $results = 20): PaginatedResponse
+    {
+        $data = $this->http->request('GET', 'compute/hypervisors', [
+            'query' => ['results' => $results],
+        ]);
+
+        return PaginatedResponse::fromArray(
+            $data,
+            fn(array $item) => Hypervisor::fromArray($item),
+        );
+    }
+
+    public function get(int $hypervisorId): Hypervisor
+    {
+        $data = $this->http->request('GET', "compute/hypervisors/{$hypervisorId}");
+
+        return Hypervisor::fromArray($data['data'] ?? $data);
+    }
+
+    public function groups(): HypervisorGroupsBuilder
+    {
+        return new HypervisorGroupsBuilder($this->http);
+    }
+}

src/Builders/HypervisorsBuilder.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace EZScale\VirtFusion\Builders;
+
+use EZScale\VirtFusion\DataObjects\ActionResult;
+use EZScale\VirtFusion\DataObjects\IpBlock;
+use EZScale\VirtFusion\DataObjects\PaginatedResponse;
+use EZScale\VirtFusion\HttpClient;
+
+class IpBlocksBuilder
+{
+    public function __construct(
+        private readonly HttpClient $http,
+    ) {
+    }
+
+    public function list(int $results = 20): PaginatedResponse
+    {
+        $data = $this->http->request('GET', 'connectivity/ipblocks', [
+            'query' => ['results' => $results],
+        ]);
+
+        return PaginatedResponse::fromArray(
+            $data,
+            fn(array $item) => IpBlock::fromArray($item),
+        );
+    }
+
+    public function get(int $blockId): IpBlock
+    {
+        $data = $this->http->request('GET', "connectivity/ipblocks/{$blockId}");
+
+        return IpBlock::fromArray($data['data'] ?? $data);
+    }
+
+    public function addIpv4Range(int $blockId, string $start, string $end): ActionResult
+    {
+        $data = $this->http->request('POST', "connectivity/ipblocks/{$blockId}/ipv4", [
+            'json' => ['type' => 'range', 'start' => $start, 'end' => $end],
+        ]);
+
+        return ActionResult::fromArray($data);
+    }
+}

src/Builders/IpBlocksBuilder.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace EZScale\VirtFusion\Builders;
+
+use EZScale\VirtFusion\HttpClient;
+
+class MediaBuilder
+{
+    public function __construct(
+        private readonly HttpClient $http,
+    ) {
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function getIso(int $isoId): array
+    {
+        $data = $this->http->request('GET', "media/iso/{$isoId}");
+
+        return $data['data'] ?? $data;
+    }
+
+    /**
+     * @return array<mixed>
+     */
+    public function templatesFromPackageSpec(int $serverPackageId): array
+    {
+        $data = $this->http->request('GET', "media/templates/fromServerPackageSpec/{$serverPackageId}");
+
+        return $data['data'] ?? [];
+    }
+}

src/Builders/MediaBuilder.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace EZScale\VirtFusion\Builders;
+
+use EZScale\VirtFusion\DataObjects\Package;
+use EZScale\VirtFusion\HttpClient;
+
+class PackagesBuilder
+{
+    public function __construct(
+        private readonly HttpClient $http,
+    ) {
+    }
+
+    /**
+     * @return Package[]
+     */
+    public function list(): array
+    {
+        $data = $this->http->request('GET', 'packages');
+
+        return array_map(
+            fn(array $item) => Package::fromArray($item),
+            $data['data'] ?? [],
+        );
+    }
+
+    public function get(int $packageId): Package
+    {
+        $data = $this->http->request('GET', "packages/{$packageId}");
+
+        return Package::fromArray($data['data'] ?? $data);
+    }
+}

src/Builders/PackagesBuilder.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace EZScale\VirtFusion\Builders;
+
+use EZScale\VirtFusion\HttpClient;
+
+class QueueBuilder
+{
+    public function __construct(
+        private readonly HttpClient $http,
+    ) {
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function get(int $queueId): array
+    {
+        $data = $this->http->request('GET', "queue/{$queueId}");
+
+        return $data['data'] ?? $data;
+    }
+}