Allow passing explicit null values for optional input members (#1542)

This makes it easier to define the array literal for input objects as
PHP does not have a syntax sugar for conditional keys in an array
literal. This is consistent with the generated code for value objects.

Even though input objects allow to omit required members in the
constructor shape (as they can be set later by using the setter), the
phpdoc type still does not allow passing null explicitly (even though
the code would deal with it until the validation run) so that static
analysis tools can catch mistakes there. Passing a required member
explicitly is intended to pass a valid value for it and not a
potentially missing one.

Author: stof

src/Input/SendTaskFailureInput.php

@@ -38,8 +38,8 @@ final class SendTaskFailureInput extends Input
     /**
      * @param array{
      *   taskToken?: string,
-     *   error?: string,
-     *   cause?: string,
+     *   error?: null|string,
+     *   cause?: null|string,
      *   '@region'?: string|null,
      * } $input
      */
@@ -54,8 +54,8 @@ public function __construct(array $input = [])
     /**
      * @param array{
      *   taskToken?: string,
-     *   error?: string,
-     *   cause?: string,
+     *   error?: null|string,
+     *   cause?: null|string,
      *   '@region'?: string|null,
      * }|SendTaskFailureInput $input
      */

src/Input/StartExecutionInput.php

@@ -86,9 +86,9 @@ final class StartExecutionInput extends Input
     /**
      * @param array{
      *   stateMachineArn?: string,
-     *   name?: string,
-     *   input?: string,
-     *   traceHeader?: string,
+     *   name?: null|string,
+     *   input?: null|string,
+     *   traceHeader?: null|string,
      *   '@region'?: string|null,
      * } $input
      */
@@ -104,9 +104,9 @@ public function __construct(array $input = [])
     /**
      * @param array{
      *   stateMachineArn?: string,
-     *   name?: string,
-     *   input?: string,
-     *   traceHeader?: string,
+     *   name?: null|string,
+     *   input?: null|string,
+     *   traceHeader?: null|string,
      *   '@region'?: string|null,
      * }|StartExecutionInput $input
      */

src/Input/StopExecutionInput.php

@@ -35,8 +35,8 @@ final class StopExecutionInput extends Input
     /**
      * @param array{
      *   executionArn?: string,
-     *   error?: string,
-     *   cause?: string,
+     *   error?: null|string,
+     *   cause?: null|string,
      *   '@region'?: string|null,
      * } $input
      */
@@ -51,8 +51,8 @@ public function __construct(array $input = [])
     /**
      * @param array{
      *   executionArn?: string,
-     *   error?: string,
-     *   cause?: string,
+     *   error?: null|string,
+     *   cause?: null|string,
      *   '@region'?: string|null,
      * }|StopExecutionInput $input
      */

src/StepFunctionsClient.php

@@ -44,8 +44,8 @@ class StepFunctionsClient extends AbstractApi
      *
      * @param array{
      *   taskToken: string,
-     *   error?: string,
-     *   cause?: string,
+     *   error?: null|string,
+     *   cause?: null|string,
      *   '@region'?: string|null,
      * }|SendTaskFailureInput $input
      *
@@ -186,9 +186,9 @@ public function sendTaskSuccess($input): SendTaskSuccessOutput
      *
      * @param array{
      *   stateMachineArn: string,
-     *   name?: string,
-     *   input?: string,
-     *   traceHeader?: string,
+     *   name?: null|string,
+     *   input?: null|string,
+     *   traceHeader?: null|string,
      *   '@region'?: string|null,
      * }|StartExecutionInput $input
      *
@@ -228,8 +228,8 @@ public function startExecution($input): StartExecutionOutput
      *
      * @param array{
      *   executionArn: string,
-     *   error?: string,
-     *   cause?: string,
+     *   error?: null|string,
+     *   cause?: null|string,
      *   '@region'?: string|null,
      * }|StopExecutionInput $input
      *