Release/v1.2.x

.github/workflows/ci.yml

@@ -2,9 +2,9 @@ name: CI
 
 on:
   push:
-    branches: [ main, develop ]
+    branches: [ main, develop, release/* ]
   pull_request:
-    branches: [ main, develop ]
+    branches: [ main, develop , release/* ]
 
 jobs:
   test:

composer.json

@@ -2,7 +2,7 @@
   "name": "volt-test/php-sdk",
   "description": "Volt Test PHP SDK - A performance testing tool for PHP Developers",
   "type": "library",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "keywords": [
     "volt-test",
     "php-sdk",

src/CloudRun.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace VoltTest;
+
+class CloudRun
+{
+    private const DASHBOARD_BASE_URL = 'https://volt-test.com';
+
+    private string $runId;
+
+    private string $testId;
+
+    private string $status;
+
+    public function __construct(string $runId, string $testId, string $status)
+    {
+        $this->runId = $runId;
+        $this->testId = $testId;
+        $this->status = $status;
+    }
+
+    public function getRunId(): string
+    {
+        return $this->runId;
+    }
+
+    public function getTestId(): string
+    {
+        return $this->testId;
+    }
+
+    public function getStatus(): string
+    {
+        return $this->status;
+    }
+
+    public function getDashboardUrl(): string
+    {
+        return self::DASHBOARD_BASE_URL . '/runs/' . $this->runId;
+    }
+
+    public function isSuccessful(): bool
+    {
+        return $this->status === 'completed';
+    }
+}

src/Configuration.php

@@ -18,8 +18,16 @@ class Configuration
 
     private array $target;
 
+    private string $httpTimeout = '';
+
     private bool $httpDebug = false;
 
+    /** @var Stage[] */
+    private array $stages = [];
+
+    /** @var array<string, int> */
+    private array $regionConfig = [];
+
     public function __construct(string $name, string $description = '')
     {
         $this->name = $name;
@@ -38,15 +46,34 @@ public function toArray(): array
         $array = [
             'name' => $this->name,
             'description' => $this->description,
-            'virtual_users' => $this->virtualUsers,
             'target' => $this->target,
             'http_debug' => $this->httpDebug,
         ];
-        if (trim($this->rampUp) !== '') {
-            $array['ramp_up'] = $this->rampUp;
+
+        if (count($this->stages) > 0) {
+            // Stages mode: omit virtual_users, duration, ramp_up
+            $array['stages'] = array_map(fn (Stage $s) => $s->toArray(), $this->stages);
+        } else {
+            // Constant mode
+            $array['virtual_users'] = $this->virtualUsers;
+            if (trim($this->rampUp) !== '') {
+                $array['ramp_up'] = $this->rampUp;
+            }
+            if (trim($this->duration) !== '') {
+                $array['duration'] = $this->duration;
+            }
         }
-        if (trim($this->duration) !== '') {
-            $array['duration'] = $this->duration;
+
+        if (trim($this->httpTimeout) !== '') {
+            $array['http_timeout'] = $this->httpTimeout;
+        }
+
+        if (count($this->regionConfig) > 0) {
+            $array['region_config'] = array_map(
+                fn (string $region, int $weight) => ['region' => $region, 'weight' => $weight],
+                array_keys($this->regionConfig),
+                array_values($this->regionConfig)
+            );
         }
 
         return $array;
@@ -82,7 +109,21 @@ public function setRampUp(string $rampUp): self
         return $this;
     }
 
-    public function setTarget(string $idleTimeout = '30s'): self
+    public function setTargetUrl(string $url): self
+    {
+        if (! preg_match('/^https?:\/\//', $url)) {
+            throw new VoltTestException('Target URL must start with http:// or https://');
+        }
+        $parsed = parse_url($url);
+        if ($parsed === false || ! isset($parsed['host'])) {
+            throw new VoltTestException('Invalid target URL');
+        }
+        $this->target['url'] = $url;
+
+        return $this;
+    }
+
+    public function setIdleTimeout(string $idleTimeout = '30s'): self
     {
         if (! preg_match('/^\d+[smh]$/', $idleTimeout)) {
             throw new VoltTestException('Invalid idle timeout format. Use <number>[s|m|h]');
@@ -92,10 +133,111 @@ public function setTarget(string $idleTimeout = '30s'): self
         return $this;
     }
 
+    /**
+     * @deprecated Use setIdleTimeout() instead
+     */
+    public function setTarget(string $idleTimeout = '30s'): self
+    {
+        return $this->setIdleTimeout($idleTimeout);
+    }
+
+    public function setHttpTimeout(string $httpTimeout): self
+    {
+        if (! preg_match('/^\d+[smh]$/', $httpTimeout)) {
+            throw new VoltTestException('Invalid HTTP timeout format. Use <number>[s|m|h]');
+        }
+        $this->httpTimeout = $httpTimeout;
+
+        return $this;
+    }
+
     public function setHttpDebug(bool $httpDebug): self
     {
         $this->httpDebug = $httpDebug;
 
         return $this;
     }
+
+    /**
+     * @throws VoltTestException
+     */
+    public function addStage(string $duration, int $target): self
+    {
+        $this->stages[] = new Stage($duration, $target);
+
+        return $this;
+    }
+
+    public function hasStages(): bool
+    {
+        return count($this->stages) > 0;
+    }
+
+    public function hasConstantLoad(): bool
+    {
+        return $this->virtualUsers > 1 || trim($this->duration) !== '' || trim($this->rampUp) !== '';
+    }
+
+    public function clearConstantLoad(): self
+    {
+        $this->virtualUsers = 1;
+        $this->duration = '';
+        $this->rampUp = '';
+
+        return $this;
+    }
+
+    /**
+     * @param array $regions Region code => weight (e.g., ['us-east-1' => 60, 'eu-west-1' => 40])
+     *
+     * @throws VoltTestException
+     */
+    public function setRegions(array $regions): self
+    {
+        if (empty($regions)) {
+            throw new VoltTestException('Region distribution cannot be empty');
+        }
+
+        foreach ($regions as $region => $weight) {
+            if (! is_string($region) || trim($region) === '') {
+                throw new VoltTestException('Region code must be a non-empty string');
+            }
+
+            if (! is_int($weight)) {
+                throw new VoltTestException('Region weight must be an integer');
+            }
+
+            if ($weight <= 0) {
+                throw new VoltTestException('Region weight must be greater than 0');
+            }
+        }
+
+        $sum = array_sum($regions);
+        if ($sum !== 100) {
+            throw new VoltTestException("Region weights must sum to 100, got {$sum}");
+        }
+
+        $this->regionConfig = $regions;
+
+        return $this;
+    }
+
+    public function hasRegions(): bool
+    {
+        return count($this->regionConfig) > 0;
+    }
+
+    public function setName(string $name): self
+    {
+        $this->name = $name;
+
+        return $this;
+    }
+
+    public function setDescription(string $description): self
+    {
+        $this->description = $description;
+
+        return $this;
+    }
 }

src/Exceptions/AuthenticationException.php

@@ -0,0 +1,7 @@
+<?php
+
+namespace VoltTest\Exceptions;
+
+class AuthenticationException extends CloudException
+{
+}

src/Exceptions/CloudConnectionException.php

@@ -0,0 +1,7 @@
+<?php
+
+namespace VoltTest\Exceptions;
+
+class CloudConnectionException extends CloudException
+{
+}

src/Exceptions/CloudException.php

@@ -0,0 +1,7 @@
+<?php
+
+namespace VoltTest\Exceptions;
+
+class CloudException extends VoltTestException
+{
+}

src/Exceptions/CloudTimeoutException.php

@@ -0,0 +1,7 @@
+<?php
+
+namespace VoltTest\Exceptions;
+
+class CloudTimeoutException extends CloudException
+{
+}

src/Exceptions/PlanLimitException.php

@@ -0,0 +1,7 @@
+<?php
+
+namespace VoltTest\Exceptions;
+
+class PlanLimitException extends CloudException
+{
+}

src/Exceptions/RunFailedException.php

@@ -0,0 +1,7 @@
+<?php
+
+namespace VoltTest\Exceptions;
+
+class RunFailedException extends CloudException
+{
+}

src/Extractors/HtmlExtractor.php

@@ -6,7 +6,6 @@
 
 class HtmlExtractor implements Extractor
 {
-
     private string $variableName;
 
     private string $selector;

src/Platform.php

@@ -6,7 +6,7 @@ class Platform
 {
     private const BINARY_NAME = 'volt-test';
 
-    private const ENGINE_CURRENT_VERSION = 'v1.1.0';
+    private const ENGINE_CURRENT_VERSION = 'v1.2.0';
     private const BASE_DOWNLOAD_URL = 'https://github.com/volt-test/binaries/releases/download';
     private const SUPPORTED_PLATFORMS = [
         'linux-amd64' => 'volt-test-linux-amd64',