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.

src/Input/GetThingShadowRequest.php

@@ -31,7 +31,7 @@ final class GetThingShadowRequest extends Input
     /**
      * @param array{
      *   thingName?: string,
-     *   shadowName?: string,
+     *   shadowName?: null|string,
      *   '@region'?: string|null,
      * } $input
      */
@@ -45,7 +45,7 @@ public function __construct(array $input = [])
     /**
      * @param array{
      *   thingName?: string,
-     *   shadowName?: string,
+     *   shadowName?: null|string,
      *   '@region'?: string|null,
      * }|GetThingShadowRequest $input
      */

src/Input/UpdateThingShadowRequest.php

@@ -40,7 +40,7 @@ final class UpdateThingShadowRequest extends Input
     /**
      * @param array{
      *   thingName?: string,
-     *   shadowName?: string,
+     *   shadowName?: null|string,
      *   payload?: string,
      *   '@region'?: string|null,
      * } $input
@@ -56,7 +56,7 @@ public function __construct(array $input = [])
     /**
      * @param array{
      *   thingName?: string,
-     *   shadowName?: string,
+     *   shadowName?: null|string,
      *   payload?: string,
      *   '@region'?: string|null,
      * }|UpdateThingShadowRequest $input

src/IotDataClient.php

@@ -39,7 +39,7 @@ class IotDataClient extends AbstractApi
      *
      * @param array{
      *   thingName: string,
-     *   shadowName?: string,
+     *   shadowName?: null|string,
      *   '@region'?: string|null,
      * }|GetThingShadowRequest $input
      *
@@ -84,7 +84,7 @@ public function getThingShadow($input): GetThingShadowResponse
      *
      * @param array{
      *   thingName: string,
-     *   shadowName?: string,
+     *   shadowName?: null|string,
      *   payload: string,
      *   '@region'?: string|null,
      * }|UpdateThingShadowRequest $input