Document all object properties as nullable

The generated objects are performing delayed validation for the required
properties, so they still accept null.

Author: stof

src/CodeGenerator/src/Generator/ObjectGenerator.php

@@ -308,7 +308,8 @@ private function addProperties(StructureShape $shape, ClassBuilder $classBuilder
             }
             $method->setReturnNullable($nullable);
             if ($parameterType) {
-                $property->addComment('@var ' . $parameterType . ($nullable ? '|null' : ''));
+                // Properties are always documented as nullable due to the delayed validation.
+                $property->addComment('@var ' . $parameterType . '|null');
             }
         }
 

src/Core/src/Sts/ValueObject/AssumedRoleUser.php

@@ -11,7 +11,7 @@ final class AssumedRoleUser
      * A unique identifier that contains the role ID and the role session name of the role that is being assumed. The role
      * ID is generated by Amazon Web Services when the role is created.
      *
-     * @var string
+     * @var string|null
      */
     private $assumedRoleId;
 
@@ -21,7 +21,7 @@ final class AssumedRoleUser
      *
      * [^1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html
      *
-     * @var string
+     * @var string|null
      */
     private $arn;
 

src/Core/src/Sts/ValueObject/Credentials.php

@@ -10,28 +10,28 @@ final class Credentials
     /**
      * The access key ID that identifies the temporary security credentials.
      *
-     * @var string
+     * @var string|null
      */
     private $accessKeyId;
 
     /**
      * The secret access key that can be used to sign requests.
      *
-     * @var string
+     * @var string|null
      */
     private $secretAccessKey;
 
     /**
      * The token that users must pass to the service API to use the temporary credentials.
      *
-     * @var string
+     * @var string|null
      */
     private $sessionToken;
 
     /**
      * The date on which the current credentials expire.
      *
-     * @var \DateTimeImmutable
+     * @var \DateTimeImmutable|null
      */
     private $expiration;
 

src/Core/src/Sts/ValueObject/Tag.php

@@ -21,7 +21,7 @@ final class Tag
      *
      * [^1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_iam-limits.html#reference_iam-limits-entity-length
      *
-     * @var string
+     * @var string|null
      */
     private $key;
 
@@ -33,7 +33,7 @@ final class Tag
      *
      * [^1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_iam-limits.html#reference_iam-limits-entity-length
      *
-     * @var string
+     * @var string|null
      */
     private $value;
 

src/Service/AppSync/src/ValueObject/AppSyncRuntime.php

@@ -15,14 +15,14 @@ final class AppSyncRuntime
     /**
      * The `name` of the runtime to use. Currently, the only allowed value is `APPSYNC_JS`.
      *
-     * @var RuntimeName::*
+     * @var RuntimeName::*|null
      */
     private $name;
 
     /**
      * The `version` of the runtime to use. Currently, the only allowed version is `1.0.0`.
      *
-     * @var string
+     * @var string|null
      */
     private $runtimeVersion;
 

src/Service/AppSync/src/ValueObject/AuthorizationConfig.php

@@ -15,7 +15,7 @@ final class AuthorizationConfig
      *
      * - **AWS_IAM**: The authorization type is Signature Version 4 (SigV4).
      *
-     * @var AuthorizationType::*
+     * @var AuthorizationType::*|null
      */
     private $authorizationType;
 

src/Service/AppSync/src/ValueObject/BadRequestDetail.php

@@ -11,7 +11,7 @@ final class BadRequestDetail
     /**
      * Contains the list of errors in the request.
      *
-     * @var CodeError[]
+     * @var CodeError[]|null
      */
     private $codeErrors;
 

src/Service/AppSync/src/ValueObject/CachingConfig.php

@@ -14,7 +14,7 @@ final class CachingConfig
      *
      * Valid values are 1–3,600 seconds.
      *
-     * @var int
+     * @var int|null
      */
     private $ttl;
 
@@ -23,7 +23,7 @@ final class CachingConfig
      *
      * Valid values are entries from the `$context.arguments`, `$context.source`, and `$context.identity` maps.
      *
-     * @var string[]
+     * @var string[]|null
      */
     private $cachingKeys;
 

src/Service/AppSync/src/ValueObject/DynamodbDataSourceConfig.php

@@ -12,14 +12,14 @@ final class DynamodbDataSourceConfig
     /**
      * The table name.
      *
-     * @var string
+     * @var string|null
      */
     private $tableName;
 
     /**
      * The Amazon Web Services Region.
      *
-     * @var string
+     * @var string|null
      */
     private $awsRegion;
 

src/Service/AppSync/src/ValueObject/ElasticsearchDataSourceConfig.php

@@ -15,14 +15,14 @@ final class ElasticsearchDataSourceConfig
     /**
      * The endpoint.
      *
-     * @var string
+     * @var string|null
      */
     private $endpoint;
 
     /**
      * The Amazon Web Services Region.
      *
-     * @var string
+     * @var string|null
      */
     private $awsRegion;
 

src/Service/AppSync/src/ValueObject/EventBridgeDataSourceConfig.php

@@ -14,7 +14,7 @@ final class EventBridgeDataSourceConfig
      *
      * [^1]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html
      *
-     * @var string
+     * @var string|null
      */
     private $eventBusArn;
 

src/Service/AppSync/src/ValueObject/LambdaDataSourceConfig.php

@@ -12,7 +12,7 @@ final class LambdaDataSourceConfig
     /**
      * The Amazon Resource Name (ARN) for the Lambda function.
      *
-     * @var string
+     * @var string|null
      */
     private $lambdaFunctionArn;
 

src/Service/AppSync/src/ValueObject/OpenSearchServiceDataSourceConfig.php

@@ -12,14 +12,14 @@ final class OpenSearchServiceDataSourceConfig
     /**
      * The endpoint.
      *
-     * @var string
+     * @var string|null
      */
     private $endpoint;
 
     /**
      * The Amazon Web Services Region.
      *
-     * @var string
+     * @var string|null
      */
     private $awsRegion;
 

src/Service/AppSync/src/ValueObject/PipelineConfig.php

@@ -10,7 +10,7 @@ final class PipelineConfig
     /**
      * A list of `Function` objects.
      *
-     * @var string[]
+     * @var string[]|null
      */
     private $functions;
 

src/Service/Athena/src/ValueObject/AclConfiguration.php

@@ -22,7 +22,7 @@ final class AclConfiguration
      *
      * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html#canned-acl
      *
-     * @var S3AclOption::*
+     * @var S3AclOption::*|null
      */
     private $s3AclOption;
 

src/Service/Athena/src/ValueObject/Column.php

@@ -10,7 +10,7 @@ final class Column
     /**
      * The name of the column.
      *
-     * @var string
+     * @var string|null
      */
     private $name;
 

src/Service/Athena/src/ValueObject/ColumnInfo.php

@@ -33,7 +33,7 @@ final class ColumnInfo
     /**
      * The name of the column.
      *
-     * @var string
+     * @var string|null
      */
     private $name;
 
@@ -47,7 +47,7 @@ final class ColumnInfo
     /**
      * The data type of the column.
      *
-     * @var string
+     * @var string|null
      */
     private $type;
 

src/Service/Athena/src/ValueObject/CustomerContentEncryptionConfiguration.php

@@ -11,7 +11,7 @@ final class CustomerContentEncryptionConfiguration
     /**
      * The KMS key that is used to encrypt the user's data stores in Athena.
      *
-     * @var string
+     * @var string|null
      */
     private $kmsKey;
 

src/Service/Athena/src/ValueObject/DataCatalog.php

@@ -17,7 +17,7 @@ final class DataCatalog
      * maximum of 127 alphanumeric, underscore, at sign, or hyphen characters. The remainder of the length constraint of 256
      * is reserved for use by Athena.
      *
-     * @var string
+     * @var string|null
      */
     private $name;
 
@@ -32,7 +32,7 @@ final class DataCatalog
      * The type of data catalog to create: `LAMBDA` for a federated catalog, `HIVE` for an external hive metastore, or
      * `GLUE` for an Glue Data Catalog.
      *
-     * @var DataCatalogType::*
+     * @var DataCatalogType::*|null
      */
     private $type;
 
@@ -65,7 +65,7 @@ final class DataCatalog
      *   - Queries that specify a Glue Data Catalog other than the default `AwsDataCatalog` must be run on Athena engine
      *     version 2.
      *
-     * @var array<string, string>
+     * @var array<string, string>|null
      */
     private $parameters;
 

src/Service/Athena/src/ValueObject/Database.php

@@ -10,7 +10,7 @@ final class Database
     /**
      * The name of the database.
      *
-     * @var string
+     * @var string|null
      */
     private $name;
 
@@ -24,7 +24,7 @@ final class Database
     /**
      * A set of custom key/value pairs.
      *
-     * @var array<string, string>
+     * @var array<string, string>|null
      */
     private $parameters;
 

src/Service/Athena/src/ValueObject/EncryptionConfiguration.php

@@ -18,7 +18,7 @@ final class EncryptionConfiguration
      * If a query runs in a workgroup and the workgroup overrides client-side settings, then the workgroup's setting for
      * encryption is used. It specifies whether query results must be encrypted, for all queries that run in this workgroup.
      *
-     * @var EncryptionOption::*
+     * @var EncryptionOption::*|null
      */
     private $encryptionOption;
 

src/Service/Athena/src/ValueObject/EngineConfiguration.php

@@ -20,7 +20,7 @@ final class EngineConfiguration
     /**
      * The maximum number of DPUs that can run concurrently.
      *
-     * @var int
+     * @var int|null
      */
     private $maxConcurrentDpus;
 
@@ -38,15 +38,15 @@ final class EngineConfiguration
      * StartSessionRequest$NotebookVersion field, and then add a key named `NotebookId` to `AdditionalConfigs` that has the
      * value of the Athena notebook ID.
      *
-     * @var array<string, string>
+     * @var array<string, string>|null
      */
     private $additionalConfigs;
 
     /**
      * Specifies custom jar files and Spark properties for use cases like cluster encryption, table formats, and general
      * Spark tuning.
      *
-     * @var array<string, string>
+     * @var array<string, string>|null
      */
     private $sparkProperties;
 

src/Service/Athena/src/ValueObject/NamedQuery.php

@@ -10,7 +10,7 @@ final class NamedQuery
     /**
      * The query name.
      *
-     * @var string
+     * @var string|null
      */
     private $name;
 
@@ -24,14 +24,14 @@ final class NamedQuery
     /**
      * The database to which the query belongs.
      *
-     * @var string
+     * @var string|null
      */
     private $database;
 
     /**
      * The SQL statements that make up the query.
      *
-     * @var string
+     * @var string|null
      */
     private $queryString;
 

src/Service/Athena/src/ValueObject/QueryExecution.php

@@ -89,7 +89,7 @@ final class QueryExecution
      * A list of values for the parameters in a query. The values are applied sequentially to the parameters in the query in
      * the order in which the parameters occur. The list of parameters is not returned in the response.
      *
-     * @var string[]
+     * @var string[]|null
      */
     private $executionParameters;
 

src/Service/Athena/src/ValueObject/ResultReuseByAgeConfiguration.php

@@ -12,7 +12,7 @@ final class ResultReuseByAgeConfiguration
     /**
      * True if previous query results can be reused when the query is run; otherwise, false. The default is false.
      *
-     * @var bool
+     * @var bool|null
      */
     private $enabled;
 

src/Service/Athena/src/ValueObject/ResultReuseInformation.php

@@ -10,7 +10,7 @@ final class ResultReuseInformation
     /**
      * True if a previous query result was reused; false if the result was generated from a new run of the query.
      *
-     * @var bool
+     * @var bool|null
      */
     private $reusedPreviousResult;
 

src/Service/Athena/src/ValueObject/ResultSet.php

@@ -11,7 +11,7 @@ final class ResultSet
     /**
      * The rows in the table.
      *
-     * @var Row[]
+     * @var Row[]|null
      */
     private $rows;