Add one-off script endpoints to Server resource

README.md

@@ -128,6 +128,13 @@ $ploi->servers(123)->opcache()->disable();
 
 // Refresh opcache
 $ploi->servers(123)->opcache()->refresh();
+
+// Run a one-off script on a server
+$response = $ploi->servers(123)->runOneOffScript('npm install -g pm2', $user = 'deployer');
+$executionId = $response->getData()->id;
+
+// Poll one-off script execution status and output
+$ploi->servers(123)->getScriptExecution($executionId);
 ```
 
 ### Sites
@@ -632,6 +639,12 @@ $ploi->scripts(123)->delete();
 
 // Run script
 $ploi->scripts(123)->run($id = null, $serverIds = []);
+
+// Run a one-off script on a server (no reusable script resource needed)
+$ploi->servers(123)->runOneOffScript($content, $user = null);
+
+// Get one-off script execution status
+$ploi->servers(123)->getScriptExecution($executionId);
 ```
 
 ### Daemons

src/Ploi/Resources/Server.php

@@ -216,6 +216,28 @@ public function restart(?int $id = null): Response
         return $this->callApi('restart', 'post');
     }
 
+    public function runOneOffScript(string $content, ?string $user = null): Response
+    {
+        $this->setIdOrFail();
+
+        $body = ['content' => $content];
+
+        if ($user !== null) {
+            $body['user'] = $user;
+        }
+
+        return $this->callApi('scripts/run', 'post', [
+            'body' => json_encode($body),
+        ]);
+    }
+
+    public function getScriptExecution(string $executionId): Response
+    {
+        $this->setIdOrFail();
+
+        return $this->callApi("scripts/run/{$executionId}");
+    }
+
     public function monitoring(?int $id = null): Response
     {
         $this->setIdOrFail($id);