Add UNKNOWN_TO_SDK value to enums (#1998)

jderusse · web-flow · commit 7e3291ed3084 · 2026-01-03T23:00:19.000+01:00
fix 1921
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Added
+
+- Add `UNKNOWN_TO_SDK` value to enums that is used when the API returns an value that is not (or not yet) known by the AsyncAws
+
 ### Changed
 
 - AWS enhancement: Documentation updates.
diff --git a/composer.json b/composer.json
@@ -33,7 +33,7 @@
     },
     "extra": {
         "branch-alias": {
-            "dev-master": "1.0-dev"
+            "dev-master": "1.1-dev"
         }
     }
 }
diff --git a/src/Enum/ContentDataSourceType.php b/src/Enum/ContentDataSourceType.php
@@ -6,7 +6,11 @@ final class ContentDataSourceType
 {
     public const CUSTOM = 'CUSTOM';
     public const S3 = 'S3';
+    public const UNKNOWN_TO_SDK = 'UNKNOWN_TO_SDK';
 
+    /**
+     * @psalm-assert-if-true self::* $value
+     */
     public static function exists(string $value): bool
     {
         return isset([
diff --git a/src/Enum/CustomSourceType.php b/src/Enum/CustomSourceType.php
@@ -7,6 +7,9 @@ final class CustomSourceType
     public const IN_LINE = 'IN_LINE';
     public const S3_LOCATION = 'S3_LOCATION';
 
+    /**
+     * @psalm-assert-if-true self::* $value
+     */
     public static function exists(string $value): bool
     {
         return isset([
diff --git a/src/Enum/DocumentStatus.php b/src/Enum/DocumentStatus.php
@@ -16,7 +16,11 @@ final class DocumentStatus
     public const PARTIALLY_INDEXED = 'PARTIALLY_INDEXED';
     public const PENDING = 'PENDING';
     public const STARTING = 'STARTING';
+    public const UNKNOWN_TO_SDK = 'UNKNOWN_TO_SDK';
 
+    /**
+     * @psalm-assert-if-true self::* $value
+     */
     public static function exists(string $value): bool
     {
         return isset([
diff --git a/src/Enum/InlineContentType.php b/src/Enum/InlineContentType.php
@@ -7,6 +7,9 @@ final class InlineContentType
     public const BYTE = 'BYTE';
     public const TEXT = 'TEXT';
 
+    /**
+     * @psalm-assert-if-true self::* $value
+     */
     public static function exists(string $value): bool
     {
         return isset([
diff --git a/src/Enum/MetadataSourceType.php b/src/Enum/MetadataSourceType.php
@@ -7,6 +7,9 @@ final class MetadataSourceType
     public const IN_LINE_ATTRIBUTE = 'IN_LINE_ATTRIBUTE';
     public const S3_LOCATION = 'S3_LOCATION';
 
+    /**
+     * @psalm-assert-if-true self::* $value
+     */
     public static function exists(string $value): bool
     {
         return isset([
diff --git a/src/Enum/MetadataValueType.php b/src/Enum/MetadataValueType.php
@@ -9,6 +9,9 @@ final class MetadataValueType
     public const STRING = 'STRING';
     public const STRING_LIST = 'STRING_LIST';
 
+    /**
+     * @psalm-assert-if-true self::* $value
+     */
     public static function exists(string $value): bool
     {
         return isset([
diff --git a/src/Result/DeleteKnowledgeBaseDocumentsResponse.php b/src/Result/DeleteKnowledgeBaseDocumentsResponse.php
@@ -2,6 +2,8 @@
 
 namespace AsyncAws\BedrockAgent\Result;
 
+use AsyncAws\BedrockAgent\Enum\ContentDataSourceType;
+use AsyncAws\BedrockAgent\Enum\DocumentStatus;
 use AsyncAws\BedrockAgent\ValueObject\CustomDocumentIdentifier;
 use AsyncAws\BedrockAgent\ValueObject\DocumentIdentifier;
 use AsyncAws\BedrockAgent\ValueObject\KnowledgeBaseDocumentDetail;
@@ -45,7 +47,7 @@ private function populateResultCustomDocumentIdentifier(array $json): CustomDocu
     private function populateResultDocumentIdentifier(array $json): DocumentIdentifier
     {
         return new DocumentIdentifier([
-            'dataSourceType' => (string) $json['dataSourceType'],
+            'dataSourceType' => !ContentDataSourceType::exists((string) $json['dataSourceType']) ? ContentDataSourceType::UNKNOWN_TO_SDK : (string) $json['dataSourceType'],
             's3' => empty($json['s3']) ? null : $this->populateResultS3Location($json['s3']),
             'custom' => empty($json['custom']) ? null : $this->populateResultCustomDocumentIdentifier($json['custom']),
         ]);
@@ -56,7 +58,7 @@ private function populateResultKnowledgeBaseDocumentDetail(array $json): Knowled
         return new KnowledgeBaseDocumentDetail([
             'knowledgeBaseId' => (string) $json['knowledgeBaseId'],
             'dataSourceId' => (string) $json['dataSourceId'],
-            'status' => (string) $json['status'],
+            'status' => !DocumentStatus::exists((string) $json['status']) ? DocumentStatus::UNKNOWN_TO_SDK : (string) $json['status'],
             'identifier' => $this->populateResultDocumentIdentifier($json['identifier']),
             'statusReason' => isset($json['statusReason']) ? (string) $json['statusReason'] : null,
             'updatedAt' => isset($json['updatedAt']) && ($d = \DateTimeImmutable::createFromFormat(\DateTimeInterface::ATOM, $json['updatedAt'])) ? $d : null,
diff --git a/src/Result/GetKnowledgeBaseDocumentsResponse.php b/src/Result/GetKnowledgeBaseDocumentsResponse.php
@@ -2,6 +2,8 @@
 
 namespace AsyncAws\BedrockAgent\Result;
 
+use AsyncAws\BedrockAgent\Enum\ContentDataSourceType;
+use AsyncAws\BedrockAgent\Enum\DocumentStatus;
 use AsyncAws\BedrockAgent\ValueObject\CustomDocumentIdentifier;
 use AsyncAws\BedrockAgent\ValueObject\DocumentIdentifier;
 use AsyncAws\BedrockAgent\ValueObject\KnowledgeBaseDocumentDetail;
@@ -45,7 +47,7 @@ private function populateResultCustomDocumentIdentifier(array $json): CustomDocu
     private function populateResultDocumentIdentifier(array $json): DocumentIdentifier
     {
         return new DocumentIdentifier([
-            'dataSourceType' => (string) $json['dataSourceType'],
+            'dataSourceType' => !ContentDataSourceType::exists((string) $json['dataSourceType']) ? ContentDataSourceType::UNKNOWN_TO_SDK : (string) $json['dataSourceType'],
             's3' => empty($json['s3']) ? null : $this->populateResultS3Location($json['s3']),
             'custom' => empty($json['custom']) ? null : $this->populateResultCustomDocumentIdentifier($json['custom']),
         ]);
@@ -56,7 +58,7 @@ private function populateResultKnowledgeBaseDocumentDetail(array $json): Knowled
         return new KnowledgeBaseDocumentDetail([
             'knowledgeBaseId' => (string) $json['knowledgeBaseId'],
             'dataSourceId' => (string) $json['dataSourceId'],
-            'status' => (string) $json['status'],
+            'status' => !DocumentStatus::exists((string) $json['status']) ? DocumentStatus::UNKNOWN_TO_SDK : (string) $json['status'],
             'identifier' => $this->populateResultDocumentIdentifier($json['identifier']),
             'statusReason' => isset($json['statusReason']) ? (string) $json['statusReason'] : null,
             'updatedAt' => isset($json['updatedAt']) && ($d = \DateTimeImmutable::createFromFormat(\DateTimeInterface::ATOM, $json['updatedAt'])) ? $d : null,
diff --git a/src/Result/IngestKnowledgeBaseDocumentsResponse.php b/src/Result/IngestKnowledgeBaseDocumentsResponse.php
@@ -2,6 +2,8 @@
 
 namespace AsyncAws\BedrockAgent\Result;
 
+use AsyncAws\BedrockAgent\Enum\ContentDataSourceType;
+use AsyncAws\BedrockAgent\Enum\DocumentStatus;
 use AsyncAws\BedrockAgent\ValueObject\CustomDocumentIdentifier;
 use AsyncAws\BedrockAgent\ValueObject\DocumentIdentifier;
 use AsyncAws\BedrockAgent\ValueObject\KnowledgeBaseDocumentDetail;
@@ -45,7 +47,7 @@ private function populateResultCustomDocumentIdentifier(array $json): CustomDocu
     private function populateResultDocumentIdentifier(array $json): DocumentIdentifier
     {
         return new DocumentIdentifier([
-            'dataSourceType' => (string) $json['dataSourceType'],
+            'dataSourceType' => !ContentDataSourceType::exists((string) $json['dataSourceType']) ? ContentDataSourceType::UNKNOWN_TO_SDK : (string) $json['dataSourceType'],
             's3' => empty($json['s3']) ? null : $this->populateResultS3Location($json['s3']),
             'custom' => empty($json['custom']) ? null : $this->populateResultCustomDocumentIdentifier($json['custom']),
         ]);
@@ -56,7 +58,7 @@ private function populateResultKnowledgeBaseDocumentDetail(array $json): Knowled
         return new KnowledgeBaseDocumentDetail([
             'knowledgeBaseId' => (string) $json['knowledgeBaseId'],
             'dataSourceId' => (string) $json['dataSourceId'],
-            'status' => (string) $json['status'],
+            'status' => !DocumentStatus::exists((string) $json['status']) ? DocumentStatus::UNKNOWN_TO_SDK : (string) $json['status'],
             'identifier' => $this->populateResultDocumentIdentifier($json['identifier']),
             'statusReason' => isset($json['statusReason']) ? (string) $json['statusReason'] : null,
             'updatedAt' => isset($json['updatedAt']) && ($d = \DateTimeImmutable::createFromFormat(\DateTimeInterface::ATOM, $json['updatedAt'])) ? $d : null,
diff --git a/src/Result/ListKnowledgeBaseDocumentsResponse.php b/src/Result/ListKnowledgeBaseDocumentsResponse.php
@@ -3,6 +3,8 @@
 namespace AsyncAws\BedrockAgent\Result;
 
 use AsyncAws\BedrockAgent\BedrockAgentClient;
+use AsyncAws\BedrockAgent\Enum\ContentDataSourceType;
+use AsyncAws\BedrockAgent\Enum\DocumentStatus;
 use AsyncAws\BedrockAgent\Input\ListKnowledgeBaseDocumentsRequest;
 use AsyncAws\BedrockAgent\ValueObject\CustomDocumentIdentifier;
 use AsyncAws\BedrockAgent\ValueObject\DocumentIdentifier;
@@ -111,7 +113,7 @@ private function populateResultCustomDocumentIdentifier(array $json): CustomDocu
     private function populateResultDocumentIdentifier(array $json): DocumentIdentifier
     {
         return new DocumentIdentifier([
-            'dataSourceType' => (string) $json['dataSourceType'],
+            'dataSourceType' => !ContentDataSourceType::exists((string) $json['dataSourceType']) ? ContentDataSourceType::UNKNOWN_TO_SDK : (string) $json['dataSourceType'],
             's3' => empty($json['s3']) ? null : $this->populateResultS3Location($json['s3']),
             'custom' => empty($json['custom']) ? null : $this->populateResultCustomDocumentIdentifier($json['custom']),
         ]);
@@ -122,7 +124,7 @@ private function populateResultKnowledgeBaseDocumentDetail(array $json): Knowled
         return new KnowledgeBaseDocumentDetail([
             'knowledgeBaseId' => (string) $json['knowledgeBaseId'],
             'dataSourceId' => (string) $json['dataSourceId'],
-            'status' => (string) $json['status'],
+            'status' => !DocumentStatus::exists((string) $json['status']) ? DocumentStatus::UNKNOWN_TO_SDK : (string) $json['status'],
             'identifier' => $this->populateResultDocumentIdentifier($json['identifier']),
             'statusReason' => isset($json['statusReason']) ? (string) $json['statusReason'] : null,
             'updatedAt' => isset($json['updatedAt']) && ($d = \DateTimeImmutable::createFromFormat(\DateTimeInterface::ATOM, $json['updatedAt'])) ? $d : null,
diff --git a/src/ValueObject/CustomContent.php b/src/ValueObject/CustomContent.php
@@ -101,6 +101,7 @@ public function requestBody(): array
         $payload['customDocumentIdentifier'] = $v->requestBody();
         $v = $this->sourceType;
         if (!CustomSourceType::exists($v)) {
+            /** @psalm-suppress NoValue */
             throw new InvalidArgument(\sprintf('Invalid parameter "sourceType" for "%s". The value "%s" is not a valid "CustomSourceType".', __CLASS__, $v));
         }
         $payload['sourceType'] = $v;
diff --git a/src/ValueObject/DocumentContent.php b/src/ValueObject/DocumentContent.php
@@ -84,6 +84,7 @@ public function requestBody(): array
         $payload = [];
         $v = $this->dataSourceType;
         if (!ContentDataSourceType::exists($v)) {
+            /** @psalm-suppress NoValue */
             throw new InvalidArgument(\sprintf('Invalid parameter "dataSourceType" for "%s". The value "%s" is not a valid "ContentDataSourceType".', __CLASS__, $v));
         }
         $payload['dataSourceType'] = $v;
diff --git a/src/ValueObject/DocumentIdentifier.php b/src/ValueObject/DocumentIdentifier.php
@@ -83,6 +83,7 @@ public function requestBody(): array
         $payload = [];
         $v = $this->dataSourceType;
         if (!ContentDataSourceType::exists($v)) {
+            /** @psalm-suppress NoValue */
             throw new InvalidArgument(\sprintf('Invalid parameter "dataSourceType" for "%s". The value "%s" is not a valid "ContentDataSourceType".', __CLASS__, $v));
         }
         $payload['dataSourceType'] = $v;
diff --git a/src/ValueObject/DocumentMetadata.php b/src/ValueObject/DocumentMetadata.php
@@ -88,6 +88,7 @@ public function requestBody(): array
         $payload = [];
         $v = $this->type;
         if (!MetadataSourceType::exists($v)) {
+            /** @psalm-suppress NoValue */
             throw new InvalidArgument(\sprintf('Invalid parameter "type" for "%s". The value "%s" is not a valid "MetadataSourceType".', __CLASS__, $v));
         }
         $payload['type'] = $v;
diff --git a/src/ValueObject/InlineContent.php b/src/ValueObject/InlineContent.php
@@ -84,6 +84,7 @@ public function requestBody(): array
         $payload = [];
         $v = $this->type;
         if (!InlineContentType::exists($v)) {
+            /** @psalm-suppress NoValue */
             throw new InvalidArgument(\sprintf('Invalid parameter "type" for "%s". The value "%s" is not a valid "InlineContentType".', __CLASS__, $v));
         }
         $payload['type'] = $v;
diff --git a/src/ValueObject/MetadataAttributeValue.php b/src/ValueObject/MetadataAttributeValue.php
@@ -116,6 +116,7 @@ public function requestBody(): array
         $payload = [];
         $v = $this->type;
         if (!MetadataValueType::exists($v)) {
+            /** @psalm-suppress NoValue */
             throw new InvalidArgument(\sprintf('Invalid parameter "type" for "%s". The value "%s" is not a valid "MetadataValueType".', __CLASS__, $v));
         }
         $payload['type'] = $v;

Original file line number	Diff line number	Diff line change
`@@ -33,7 +33,7 @@`
`33`	`33`	`},`
`34`	`34`	`"extra": {`
`35`	`35`	`"branch-alias": {`
`36`		`- "dev-master": "1.0-dev"`
	`36`	`+ "dev-master": "1.1-dev"`
`37`	`37`	`}`
`38`	`38`	`}`
`39`	`39`	`}`
Original file line number	Diff line number	Diff line change
`@@ -6,7 +6,11 @@ final class ContentDataSourceType`
`6`	`6`	`{`
`7`	`7`	`public const CUSTOM = 'CUSTOM';`
`8`	`8`	`public const S3 = 'S3';`
	`9`	`+ public const UNKNOWN_TO_SDK = 'UNKNOWN_TO_SDK';`
`9`	`10`
	`11`	`+ /**`
	`12`	`+ * @psalm-assert-if-true self::* $value`
	`13`	`+ */`
`10`	`14`	`public static function exists(string $value): bool`
`11`	`15`	`{`
`12`	`16`	`return isset([`
Original file line number	Diff line number	Diff line change
`@@ -7,6 +7,9 @@ final class CustomSourceType`
`7`	`7`	`public const IN_LINE = 'IN_LINE';`
`8`	`8`	`public const S3_LOCATION = 'S3_LOCATION';`
`9`	`9`
	`10`	`+ /**`
	`11`	`+ * @psalm-assert-if-true self::* $value`
	`12`	`+ */`
`10`	`13`	`public static function exists(string $value): bool`
`11`	`14`	`{`
`12`	`15`	`return isset([`
Original file line number	Diff line number	Diff line change
`@@ -7,6 +7,9 @@ final class InlineContentType`
`7`	`7`	`public const BYTE = 'BYTE';`
`8`	`8`	`public const TEXT = 'TEXT';`
`9`	`9`
	`10`	`+ /**`
	`11`	`+ * @psalm-assert-if-true self::* $value`
	`12`	`+ */`
`10`	`13`	`public static function exists(string $value): bool`
`11`	`14`	`{`
`12`	`15`	`return isset([`
Original file line number	Diff line number	Diff line change
`@@ -7,6 +7,9 @@ final class MetadataSourceType`
`7`	`7`	`public const IN_LINE_ATTRIBUTE = 'IN_LINE_ATTRIBUTE';`
`8`	`8`	`public const S3_LOCATION = 'S3_LOCATION';`
`9`	`9`
	`10`	`+ /**`
	`11`	`+ * @psalm-assert-if-true self::* $value`
	`12`	`+ */`
`10`	`13`	`public static function exists(string $value): bool`
`11`	`14`	`{`
`12`	`15`	`return isset([`
Original file line number	Diff line number	Diff line change
`@@ -9,6 +9,9 @@ final class MetadataValueType`
`9`	`9`	`public const STRING = 'STRING';`
`10`	`10`	`public const STRING_LIST = 'STRING_LIST';`
`11`	`11`
	`12`	`+ /**`
	`13`	`+ * @psalm-assert-if-true self::* $value`
	`14`	`+ */`
`12`	`15`	`public static function exists(string $value): bool`
`13`	`16`	`{`
`14`	`17`	`return isset([`