Phase9

2026-06-26 13:46:25 +02:00
parent b335f6a497
commit ed8334328e
49 changed files with 2219 additions and 16 deletions
--- a/integrations/whmcs/README.md
+++ b/integrations/whmcs/README.md
@@ -52,7 +52,10 @@ Handles global configuration:

 ## Status

-**Phase 0:** Directory placeholders only. Implementation follows MVP Phase 9 and WHMCS phases A–F documented in the master specification.
+**Phase 9 (WHMCS Phase A–B + production DNS)** — implemented.
+
+- Server module: `integrations/whmcs/modules/servers/hexagamecloud/`
+- Addon module: planned for global mappings and reconciliation UI

 ## Documentation (planned)

--- a/integrations/whmcs/modules/servers/hexagamecloud/hexagamecloud.php
+++ b/integrations/whmcs/modules/servers/hexagamecloud/hexagamecloud.php
@@ -0,0 +1,144 @@
+<?php
+
+if (!defined('WHMCS')) {
+    die('This file cannot be accessed directly');
+}
+
+require_once __DIR__ . '/lib/ApiClient.php';
+
+function hexagamecloud_MetaData(): array
+{
+    return [
+        'DisplayName' => 'HexaHost GameCloud',
+        'APIVersion' => '1.1',
+        'RequiresServer' => true,
+        'DefaultNonSSLPort' => '443',
+        'DefaultSSLPort' => '443',
+    ];
+}
+
+function hexagamecloud_ConfigOptions(): array
+{
+    return [
+        'plan_slug' => [
+            'FriendlyName' => 'GameCloud Plan Slug',
+            'Type' => 'text',
+            'Size' => '32',
+            'Default' => 'free',
+            'Description' => 'Maps to a GameCloud plan slug',
+        ],
+        'minecraft_version' => [
+            'FriendlyName' => 'Minecraft Version',
+            'Type' => 'text',
+            'Size' => '16',
+            'Default' => '1.21.1',
+        ],
+        'software_family' => [
+            'FriendlyName' => 'Software Family',
+            'Type' => 'dropdown',
+            'Options' => 'VANILLA,PAPER,PURPUR,FABRIC,FORGE,NEOFORGE,QUILT',
+            'Default' => 'VANILLA',
+        ],
+    ];
+}
+
+function hexagamecloud_CreateAccount(array $params): string
+{
+    try {
+        $client = new HexaGameCloudApiClient($params);
+        $externalClientId = (string) $params['clientsdetails']['userid'];
+        $externalServiceId = (string) $params['serviceid'];
+
+        $client->upsertClient($externalClientId, [
+            'email' => $params['clientsdetails']['email'],
+            'username' => $params['clientsdetails']['email'],
+            'displayName' => trim(($params['clientsdetails']['firstname'] ?? '') . ' ' . ($params['clientsdetails']['lastname'] ?? '')),
+        ]);
+
+        $response = $client->provisionService([
+            'externalServiceId' => $externalServiceId,
+            'externalClientId' => $externalClientId,
+            'externalProductId' => (string) ($params['pid'] ?? ''),
+            'planSlug' => $params['configoption1'] ?: 'free',
+            'serverName' => $params['domain'] ?: ('server-' . $externalServiceId),
+            'minecraftVersion' => $params['configoption2'] ?: '1.21.1',
+            'softwareFamily' => $params['configoption3'] ?: 'VANILLA',
+            'edition' => 'JAVA',
+            'eulaAccepted' => true,
+        ]);
+
+        return 'success';
+    } catch (Throwable $exception) {
+        logModuleCall(
+            'hexagamecloud',
+            __FUNCTION__,
+            $params,
+            $exception->getMessage(),
+            $exception->getMessage(),
+            ['password', 'secret', 'apiSecret']
+        );
+        return $exception->getMessage();
+    }
+}
+
+function hexagamecloud_SuspendAccount(array $params): string
+{
+    return hexagamecloud_lifecycleAction($params, 'suspend', ['reason' => 'Suspended in WHMCS']);
+}
+
+function hexagamecloud_UnsuspendAccount(array $params): string
+{
+    return hexagamecloud_lifecycleAction($params, 'unsuspend');
+}
+
+function hexagamecloud_TerminateAccount(array $params): string
+{
+    return hexagamecloud_lifecycleAction($params, 'terminate');
+}
+
+function hexagamecloud_ChangePackage(array $params): string
+{
+    try {
+        $client = new HexaGameCloudApiClient($params);
+        $client->changePackage((string) $params['serviceid'], [
+            'planSlug' => $params['configoption1'] ?: 'free',
+        ]);
+        return 'success';
+    } catch (Throwable $exception) {
+        logModuleCall('hexagamecloud', __FUNCTION__, $params, $exception->getMessage());
+        return $exception->getMessage();
+    }
+}
+
+function hexagamecloud_TestConnection(array $params): array
+{
+    try {
+        $client = new HexaGameCloudApiClient($params);
+        $health = $client->health();
+        return [
+            'success' => true,
+            'error' => 'Connected to ' . ($health['integrationId'] ?? 'GameCloud'),
+        ];
+    } catch (Throwable $exception) {
+        return ['success' => false, 'error' => $exception->getMessage()];
+    }
+}
+
+function hexagamecloud_lifecycleAction(array $params, string $action, array $body = []): string
+{
+    try {
+        $client = new HexaGameCloudApiClient($params);
+        $serviceId = (string) $params['serviceid'];
+        if ($action === 'suspend') {
+            $client->suspendService($serviceId, $body);
+        } elseif ($action === 'unsuspend') {
+            $client->unsuspendService($serviceId);
+        } else {
+            $client->terminateService($serviceId);
+        }
+        return 'success';
+    } catch (Throwable $exception) {
+        logModuleCall('hexagamecloud', $action, $params, $exception->getMessage());
+        return $exception->getMessage();
+    }
+}
--- a/integrations/whmcs/modules/servers/hexagamecloud/lib/ApiClient.php
+++ b/integrations/whmcs/modules/servers/hexagamecloud/lib/ApiClient.php
@@ -0,0 +1,147 @@
+<?php
+
+declare(strict_types=1);
+
+final class HexaGameCloudApiClient
+{
+    private string $baseUrl;
+    private string $integrationId;
+    private string $apiSecret;
+
+    public function __construct(array $params)
+    {
+        $host = rtrim((string) ($params['serverhostname'] ?? ''), '/');
+        $this->baseUrl = $host;
+        $this->integrationId = (string) ($params['serverusername'] ?? '');
+        $this->apiSecret = (string) ($params['serverpassword'] ?? '');
+
+        if ($this->baseUrl === '' || $this->integrationId === '' || $this->apiSecret === '') {
+            throw new RuntimeException('GameCloud server hostname, integration ID and API secret are required');
+        }
+    }
+
+    public function health(): array
+    {
+        return $this->request('GET', '/api/v1/integrations/whmcs/health');
+    }
+
+    public function upsertClient(string $externalClientId, array $payload): array
+    {
+        return $this->request(
+            'PUT',
+            '/api/v1/integrations/whmcs/clients/' . rawurlencode($externalClientId),
+            $payload,
+            'client:' . $externalClientId
+        );
+    }
+
+    public function provisionService(array $payload): array
+    {
+        return $this->request(
+            'POST',
+            '/api/v1/integrations/whmcs/services',
+            $payload,
+            'service:provision:' . $payload['externalServiceId']
+        );
+    }
+
+    public function suspendService(string $externalServiceId, array $payload = []): array
+    {
+        return $this->request(
+            'POST',
+            '/api/v1/integrations/whmcs/services/' . rawurlencode($externalServiceId) . '/suspend',
+            $payload,
+            'service:suspend:' . $externalServiceId
+        );
+    }
+
+    public function unsuspendService(string $externalServiceId): array
+    {
+        return $this->request(
+            'POST',
+            '/api/v1/integrations/whmcs/services/' . rawurlencode($externalServiceId) . '/unsuspend',
+            [],
+            'service:unsuspend:' . $externalServiceId
+        );
+    }
+
+    public function terminateService(string $externalServiceId): array
+    {
+        return $this->request(
+            'POST',
+            '/api/v1/integrations/whmcs/services/' . rawurlencode($externalServiceId) . '/terminate',
+            [],
+            'service:terminate:' . $externalServiceId
+        );
+    }
+
+    public function changePackage(string $externalServiceId, array $payload): array
+    {
+        return $this->request(
+            'PATCH',
+            '/api/v1/integrations/whmcs/services/' . rawurlencode($externalServiceId) . '/change-package',
+            $payload,
+            'service:change-package:' . $externalServiceId
+        );
+    }
+
+    private function request(string $method, string $path, array $body = [], ?string $idempotencySuffix = null): array
+    {
+        $bodyJson = $body === [] ? '' : json_encode($body, JSON_THROW_ON_ERROR);
+        $timestamp = (string) (int) (microtime(true) * 1000);
+        $nonce = bin2hex(random_bytes(16));
+        $idempotencyKey = $idempotencySuffix ?: $method . ':' . $path . ':' . $timestamp;
+
+        $signatureBase = implode("\n", [
+            strtoupper($method),
+            $path,
+            '',
+            hash('sha256', $bodyJson),
+            $timestamp,
+            $nonce,
+            $idempotencyKey,
+        ]);
+
+        $signature = hash_hmac('sha256', $signatureBase, $this->apiSecret);
+
+        $ch = curl_init($this->baseUrl . $path);
+        if ($ch === false) {
+            throw new RuntimeException('Unable to initialize HTTP client');
+        }
+
+        curl_setopt_array($ch, [
+            CURLOPT_CUSTOMREQUEST => $method,
+            CURLOPT_RETURNTRANSFER => true,
+            CURLOPT_TIMEOUT => 30,
+            CURLOPT_HTTPHEADER => [
+                'Content-Type: application/json',
+                'Accept: application/json',
+                'X-HGC-Integration-ID: ' . $this->integrationId,
+                'X-HGC-Timestamp: ' . $timestamp,
+                'X-HGC-Nonce: ' . $nonce,
+                'X-HGC-Idempotency-Key: ' . $idempotencyKey,
+                'X-HGC-Signature: ' . $signature,
+            ],
+            CURLOPT_POSTFIELDS => $bodyJson,
+        ]);
+
+        $responseBody = curl_exec($ch);
+        $statusCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
+        $curlError = curl_error($ch);
+        curl_close($ch);
+
+        if ($responseBody === false) {
+            throw new RuntimeException('GameCloud request failed: ' . $curlError);
+        }
+
+        $decoded = json_decode($responseBody, true);
+        if ($statusCode >= 400) {
+            $message = is_array($decoded)
+                ? ($decoded['detail'] ?? $decoded['title'] ?? $responseBody)
+                : $responseBody;
+            throw new RuntimeException('GameCloud API error (' . $statusCode . '): ' . $message);
+        }
+
+        return is_array($decoded) ? $decoded : [];
+    }
+}