Utilize SensitiveParameter attribute (#4122)

* Utilize SensitiveParameter attribute

* fix build

Author: staabm

docs/api.md

@@ -233,6 +233,7 @@ run(
     string  $command,
     ?string $cwd = null,
     ?array  $env = null,
+    #[\SensitiveParameter]
     ?string $secret = null,
     ?bool   $nothrow = false,
     ?bool   $forceOutput = false,
@@ -278,6 +279,7 @@ runLocally(
     ?string $cwd = null,
     ?int    $timeout = null,
     ?int    $idleTimeout = null,
+    #[\SensitiveParameter]
     ?string $secret = null,
     ?array  $env = null,
     ?bool   $forceOutput = false,

src/Ssh/RunParams.php

@@ -13,10 +13,12 @@ public function __construct(
         public ?int    $timeout = null,
         public ?int    $idleTimeout = null,
         public bool    $forceOutput = false,
+        #[\SensitiveParameter]
         public ?array  $secrets = null,
     ) {}
 
     public function with(
+        #[\SensitiveParameter]
         ?array $secrets = null,
         ?int $timeout = null,
     ): self {

src/functions.php

@@ -393,6 +393,7 @@ function run(
     string  $command,
     ?string $cwd = null,
     ?array  $env = null,
+    #[\SensitiveParameter]
     ?string $secret = null,
     ?bool   $nothrow = false,
     ?bool   $forceOutput = false,
@@ -483,6 +484,7 @@ function runLocally(
     ?string $cwd = null,
     ?int    $timeout = null,
     ?int    $idleTimeout = null,
+    #[\SensitiveParameter]
     ?string $secret = null,
     ?array  $env = null,
     ?bool   $forceOutput = false,