@mavogel/awscdk-rootmail 0.0.328 → 0.0.330

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (193) hide show
  1. package/.claude/settings.local.json +6 -2
  2. package/.jsii +4837 -117
  3. package/API.md +9 -3
  4. package/lib/rootmail.d.ts +2 -0
  5. package/lib/rootmail.js +2 -2
  6. package/lib/ses-receipt-ruleset-activation.d.ts +1 -1
  7. package/lib/ses-receipt-ruleset-activation.js +1 -1
  8. package/lib/ses-receive.d.ts +5 -1
  9. package/lib/ses-receive.js +2 -2
  10. package/node_modules/@aws-sdk/client-cloudwatch-logs/README.md +26 -46
  11. package/node_modules/@aws-sdk/client-cloudwatch-logs/package.json +37 -37
  12. package/node_modules/@aws-sdk/client-route-53/README.md +26 -46
  13. package/node_modules/@aws-sdk/client-route-53/package.json +36 -36
  14. package/node_modules/@aws-sdk/client-s3/README.md +26 -46
  15. package/node_modules/@aws-sdk/client-s3/dist-cjs/index.js +5 -0
  16. package/node_modules/@aws-sdk/client-s3/dist-cjs/schemas/schemas_0.js +6 -4
  17. package/node_modules/@aws-sdk/client-s3/dist-es/models/enums.js +4 -0
  18. package/node_modules/@aws-sdk/client-s3/dist-es/schemas/schemas_0.js +6 -4
  19. package/node_modules/@aws-sdk/client-s3/dist-types/commands/CopyObjectCommand.d.ts +5 -4
  20. package/node_modules/@aws-sdk/client-s3/dist-types/commands/CreateBucketCommand.d.ts +9 -0
  21. package/node_modules/@aws-sdk/client-s3/dist-types/commands/DeleteBucketTaggingCommand.d.ts +0 -1
  22. package/node_modules/@aws-sdk/client-s3/dist-types/commands/GetBucketTaggingCommand.d.ts +0 -1
  23. package/node_modules/@aws-sdk/client-s3/dist-types/commands/HeadBucketCommand.d.ts +5 -4
  24. package/node_modules/@aws-sdk/client-s3/dist-types/commands/UploadPartCopyCommand.d.ts +5 -4
  25. package/node_modules/@aws-sdk/client-s3/dist-types/models/enums.d.ts +12 -0
  26. package/node_modules/@aws-sdk/client-s3/dist-types/models/models_0.d.ts +24 -2
  27. package/node_modules/@aws-sdk/client-s3/dist-types/ts3.4/models/enums.d.ts +6 -0
  28. package/node_modules/@aws-sdk/client-s3/dist-types/ts3.4/models/models_0.d.ts +2 -0
  29. package/node_modules/@aws-sdk/client-s3/package.json +50 -50
  30. package/node_modules/@aws-sdk/client-ses/README.md +26 -46
  31. package/node_modules/@aws-sdk/client-ses/package.json +34 -34
  32. package/node_modules/@aws-sdk/client-ssm/README.md +26 -46
  33. package/node_modules/@aws-sdk/client-ssm/package.json +34 -34
  34. package/node_modules/@aws-sdk/core/package.json +11 -11
  35. package/node_modules/@aws-sdk/crc64-nvme/package.json +2 -2
  36. package/node_modules/@aws-sdk/credential-provider-env/package.json +5 -5
  37. package/node_modules/@aws-sdk/credential-provider-http/package.json +10 -10
  38. package/node_modules/@aws-sdk/credential-provider-ini/package.json +14 -14
  39. package/node_modules/@aws-sdk/credential-provider-login/package.json +8 -8
  40. package/node_modules/@aws-sdk/credential-provider-node/package.json +12 -12
  41. package/node_modules/@aws-sdk/credential-provider-process/package.json +6 -6
  42. package/node_modules/@aws-sdk/credential-provider-sso/package.json +8 -8
  43. package/node_modules/@aws-sdk/credential-provider-web-identity/package.json +7 -7
  44. package/node_modules/@aws-sdk/middleware-bucket-endpoint/package.json +5 -5
  45. package/node_modules/@aws-sdk/middleware-expect-continue/package.json +4 -4
  46. package/node_modules/@aws-sdk/middleware-flexible-checksums/dist-cjs/index.js +19 -7
  47. package/node_modules/@aws-sdk/middleware-flexible-checksums/dist-es/flexibleChecksumsResponseMiddleware.js +10 -2
  48. package/node_modules/@aws-sdk/middleware-flexible-checksums/dist-es/getChecksumAlgorithmListForResponse.js +10 -6
  49. package/node_modules/@aws-sdk/middleware-flexible-checksums/package.json +10 -10
  50. package/node_modules/@aws-sdk/middleware-host-header/package.json +4 -4
  51. package/node_modules/@aws-sdk/middleware-location-constraint/package.json +3 -3
  52. package/node_modules/@aws-sdk/middleware-logger/package.json +3 -3
  53. package/node_modules/@aws-sdk/middleware-recursion-detection/package.json +4 -4
  54. package/node_modules/@aws-sdk/middleware-sdk-route53/package.json +3 -3
  55. package/node_modules/@aws-sdk/middleware-sdk-s3/package.json +11 -11
  56. package/node_modules/@aws-sdk/middleware-ssec/package.json +3 -3
  57. package/node_modules/@aws-sdk/middleware-user-agent/package.json +8 -8
  58. package/node_modules/@aws-sdk/nested-clients/package.json +32 -32
  59. package/node_modules/@aws-sdk/region-config-resolver/package.json +5 -5
  60. package/node_modules/@aws-sdk/signature-v4-multi-region/package.json +6 -6
  61. package/node_modules/@aws-sdk/token-providers/package.json +7 -7
  62. package/node_modules/@aws-sdk/types/package.json +2 -2
  63. package/node_modules/@aws-sdk/util-endpoints/package.json +5 -5
  64. package/node_modules/@aws-sdk/util-user-agent-browser/package.json +3 -3
  65. package/node_modules/@aws-sdk/util-user-agent-node/dist-cjs/index.js +75 -19
  66. package/node_modules/@aws-sdk/util-user-agent-node/dist-es/getNodeModulesParentDirs.js +15 -0
  67. package/node_modules/@aws-sdk/util-user-agent-node/dist-es/getSanitizedDevTypeScriptVersion.js +14 -0
  68. package/node_modules/@aws-sdk/util-user-agent-node/dist-es/getTypeScriptUserAgentPair.js +53 -7
  69. package/node_modules/@aws-sdk/util-user-agent-node/dist-types/{getTypeScriptPackageJsonPaths.d.ts → getNodeModulesParentDirs.d.ts} +2 -2
  70. package/node_modules/@aws-sdk/util-user-agent-node/dist-types/getSanitizedDevTypeScriptVersion.d.ts +8 -0
  71. package/node_modules/@aws-sdk/util-user-agent-node/dist-types/ts3.4/getNodeModulesParentDirs.d.ts +1 -0
  72. package/node_modules/@aws-sdk/util-user-agent-node/dist-types/ts3.4/getSanitizedDevTypeScriptVersion.d.ts +3 -0
  73. package/node_modules/@aws-sdk/util-user-agent-node/package.json +6 -5
  74. package/node_modules/@aws-sdk/xml-builder/package.json +2 -2
  75. package/node_modules/@smithy/abort-controller/package.json +2 -2
  76. package/node_modules/@smithy/config-resolver/package.json +5 -5
  77. package/node_modules/@smithy/core/dist-cjs/index.js +1 -2
  78. package/node_modules/@smithy/core/dist-cjs/submodules/cbor/index.js +7 -1
  79. package/node_modules/@smithy/core/dist-cjs/submodules/endpoints/index.js +22 -0
  80. package/node_modules/@smithy/core/dist-cjs/submodules/protocols/index.js +11 -1
  81. package/node_modules/@smithy/core/dist-cjs/submodules/schema/index.js +41 -4
  82. package/node_modules/@smithy/core/dist-es/middleware-http-auth-scheme/getHttpAuthSchemePlugin.js +1 -2
  83. package/node_modules/@smithy/core/dist-es/submodules/cbor/parseCborBody.js +7 -1
  84. package/node_modules/@smithy/core/dist-es/submodules/endpoints/index.js +1 -0
  85. package/node_modules/@smithy/core/dist-es/submodules/endpoints/toEndpointV1.js +17 -0
  86. package/node_modules/@smithy/core/dist-es/submodules/protocols/HttpProtocol.js +10 -0
  87. package/node_modules/@smithy/core/dist-es/submodules/protocols/RpcProtocol.js +1 -1
  88. package/node_modules/@smithy/core/dist-es/submodules/schema/middleware/schemaSerializationMiddleware.js +3 -2
  89. package/node_modules/@smithy/core/dist-es/submodules/schema/schemas/NormalizedSchema.js +30 -1
  90. package/node_modules/@smithy/core/dist-es/submodules/schema/schemas/translateTraits.js +5 -1
  91. package/node_modules/@smithy/core/dist-types/submodules/endpoints/index.d.ts +1 -0
  92. package/node_modules/@smithy/core/dist-types/submodules/endpoints/toEndpointV1.d.ts +6 -0
  93. package/node_modules/@smithy/core/dist-types/submodules/schema/schemas/NormalizedSchema.d.ts +11 -0
  94. package/node_modules/@smithy/core/dist-types/submodules/schema/schemas/translateTraits.d.ts +6 -0
  95. package/node_modules/@smithy/core/dist-types/ts3.4/submodules/endpoints/index.d.ts +1 -0
  96. package/node_modules/@smithy/core/dist-types/ts3.4/submodules/endpoints/toEndpointV1.d.ts +6 -0
  97. package/node_modules/@smithy/core/dist-types/ts3.4/submodules/schema/schemas/NormalizedSchema.d.ts +11 -0
  98. package/node_modules/@smithy/core/dist-types/ts3.4/submodules/schema/schemas/translateTraits.d.ts +6 -0
  99. package/node_modules/@smithy/core/endpoints.d.ts +7 -0
  100. package/node_modules/@smithy/core/endpoints.js +6 -0
  101. package/node_modules/@smithy/core/package.json +16 -7
  102. package/node_modules/@smithy/credential-provider-imds/package.json +5 -5
  103. package/node_modules/@smithy/eventstream-codec/package.json +2 -2
  104. package/node_modules/@smithy/eventstream-serde-browser/package.json +3 -3
  105. package/node_modules/@smithy/eventstream-serde-config-resolver/package.json +2 -2
  106. package/node_modules/@smithy/eventstream-serde-node/package.json +3 -3
  107. package/node_modules/@smithy/eventstream-serde-universal/package.json +3 -3
  108. package/node_modules/@smithy/fetch-http-handler/dist-cjs/index.js +4 -1
  109. package/node_modules/@smithy/fetch-http-handler/dist-es/fetch-http-handler.js +4 -1
  110. package/node_modules/@smithy/fetch-http-handler/package.json +5 -5
  111. package/node_modules/@smithy/hash-blob-browser/package.json +2 -2
  112. package/node_modules/@smithy/hash-node/package.json +2 -2
  113. package/node_modules/@smithy/hash-stream-node/package.json +2 -2
  114. package/node_modules/@smithy/invalid-dependency/package.json +2 -2
  115. package/node_modules/@smithy/md5-js/package.json +2 -2
  116. package/node_modules/@smithy/middleware-content-length/package.json +3 -3
  117. package/node_modules/@smithy/middleware-endpoint/dist-cjs/index.js +17 -1
  118. package/node_modules/@smithy/middleware-endpoint/dist-es/adaptors/getEndpointFromInstructions.js +9 -0
  119. package/node_modules/@smithy/middleware-endpoint/dist-es/adaptors/toEndpointV1.js +8 -1
  120. package/node_modules/@smithy/middleware-endpoint/dist-types/adaptors/toEndpointV1.d.ts +1 -0
  121. package/node_modules/@smithy/middleware-endpoint/dist-types/ts3.4/adaptors/toEndpointV1.d.ts +1 -0
  122. package/node_modules/@smithy/middleware-endpoint/package.json +8 -8
  123. package/node_modules/@smithy/middleware-retry/dist-cjs/index.js +9 -12
  124. package/node_modules/@smithy/middleware-retry/dist-es/configurations.js +9 -12
  125. package/node_modules/@smithy/middleware-retry/package.json +8 -8
  126. package/node_modules/@smithy/middleware-serde/dist-cjs/index.js +3 -2
  127. package/node_modules/@smithy/middleware-serde/dist-es/serializerMiddleware.js +3 -2
  128. package/node_modules/@smithy/middleware-serde/package.json +4 -3
  129. package/node_modules/@smithy/middleware-stack/package.json +2 -2
  130. package/node_modules/@smithy/node-config-provider/package.json +4 -4
  131. package/node_modules/@smithy/node-http-handler/dist-cjs/index.js +48 -38
  132. package/node_modules/@smithy/node-http-handler/dist-es/build-abort-error.js +4 -1
  133. package/node_modules/@smithy/node-http-handler/dist-es/node-http-handler.js +38 -31
  134. package/node_modules/@smithy/node-http-handler/dist-es/node-http2-connection-manager.js +1 -1
  135. package/node_modules/@smithy/node-http-handler/dist-es/node-http2-handler.js +1 -1
  136. package/node_modules/@smithy/node-http-handler/dist-es/readable.mock.js +1 -1
  137. package/node_modules/@smithy/node-http-handler/dist-es/server.mock.js +6 -6
  138. package/node_modules/@smithy/node-http-handler/dist-es/stream-collector/collector.js +1 -1
  139. package/node_modules/@smithy/node-http-handler/dist-es/stream-collector/readable.mock.js +1 -1
  140. package/node_modules/@smithy/node-http-handler/dist-es/write-request-body.js +1 -1
  141. package/node_modules/@smithy/node-http-handler/dist-types/build-abort-error.d.ts +4 -3
  142. package/node_modules/@smithy/node-http-handler/dist-types/get-transformed-headers.d.ts +1 -1
  143. package/node_modules/@smithy/node-http-handler/dist-types/node-http-handler.d.ts +4 -4
  144. package/node_modules/@smithy/node-http-handler/dist-types/node-http2-connection-manager.d.ts +1 -1
  145. package/node_modules/@smithy/node-http-handler/dist-types/node-http2-connection-pool.d.ts +1 -1
  146. package/node_modules/@smithy/node-http-handler/dist-types/readable.mock.d.ts +2 -2
  147. package/node_modules/@smithy/node-http-handler/dist-types/server.mock.d.ts +3 -3
  148. package/node_modules/@smithy/node-http-handler/dist-types/set-connection-timeout.d.ts +1 -1
  149. package/node_modules/@smithy/node-http-handler/dist-types/set-request-timeout.d.ts +1 -1
  150. package/node_modules/@smithy/node-http-handler/dist-types/set-socket-keep-alive.d.ts +1 -1
  151. package/node_modules/@smithy/node-http-handler/dist-types/set-socket-timeout.d.ts +1 -1
  152. package/node_modules/@smithy/node-http-handler/dist-types/stream-collector/collector.d.ts +1 -1
  153. package/node_modules/@smithy/node-http-handler/dist-types/stream-collector/readable.mock.d.ts +2 -2
  154. package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/build-abort-error.d.ts +4 -3
  155. package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/get-transformed-headers.d.ts +1 -1
  156. package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/node-http-handler.d.ts +4 -4
  157. package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/node-http2-connection-manager.d.ts +1 -1
  158. package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/node-http2-connection-pool.d.ts +1 -1
  159. package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/readable.mock.d.ts +2 -2
  160. package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/server.mock.d.ts +3 -3
  161. package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/set-connection-timeout.d.ts +1 -1
  162. package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/set-request-timeout.d.ts +1 -1
  163. package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/set-socket-keep-alive.d.ts +1 -1
  164. package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/set-socket-timeout.d.ts +1 -1
  165. package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/stream-collector/collector.d.ts +1 -1
  166. package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/stream-collector/readable.mock.d.ts +2 -2
  167. package/node_modules/@smithy/node-http-handler/dist-types/ts3.4/write-request-body.d.ts +2 -2
  168. package/node_modules/@smithy/node-http-handler/dist-types/write-request-body.d.ts +2 -2
  169. package/node_modules/@smithy/node-http-handler/package.json +5 -5
  170. package/node_modules/@smithy/property-provider/package.json +2 -2
  171. package/node_modules/@smithy/protocol-http/package.json +2 -2
  172. package/node_modules/@smithy/querystring-builder/package.json +2 -2
  173. package/node_modules/@smithy/querystring-parser/package.json +2 -2
  174. package/node_modules/@smithy/service-error-classification/package.json +2 -2
  175. package/node_modules/@smithy/shared-ini-file-loader/package.json +2 -2
  176. package/node_modules/@smithy/signature-v4/package.json +4 -4
  177. package/node_modules/@smithy/smithy-client/package.json +7 -7
  178. package/node_modules/@smithy/types/dist-types/http.d.ts +1 -0
  179. package/node_modules/@smithy/types/dist-types/ts3.4/http.d.ts +1 -0
  180. package/node_modules/@smithy/types/package.json +1 -1
  181. package/node_modules/@smithy/url-parser/package.json +3 -3
  182. package/node_modules/@smithy/util-defaults-mode-browser/package.json +4 -4
  183. package/node_modules/@smithy/util-defaults-mode-node/package.json +7 -7
  184. package/node_modules/@smithy/util-endpoints/package.json +3 -3
  185. package/node_modules/@smithy/util-middleware/package.json +2 -2
  186. package/node_modules/@smithy/util-retry/package.json +3 -3
  187. package/node_modules/@smithy/util-stream/package.json +4 -4
  188. package/node_modules/@smithy/util-waiter/dist-cjs/index.js +1 -1
  189. package/node_modules/@smithy/util-waiter/dist-es/poller.js +1 -1
  190. package/node_modules/@smithy/util-waiter/package.json +3 -3
  191. package/package.json +17 -17
  192. package/node_modules/@aws-sdk/util-user-agent-node/dist-es/getTypeScriptPackageJsonPaths.js +0 -17
  193. package/node_modules/@aws-sdk/util-user-agent-node/dist-types/ts3.4/getTypeScriptPackageJsonPaths.d.ts +0 -3
@@ -1,5 +1,5 @@
1
1
  import { StreamingBlobTypes } from "@smithy/types";
2
- import { AnalyticsS3ExportFileFormat, ArchiveStatus, BucketAbacStatus, BucketAccelerateStatus, BucketCannedACL, BucketLocationConstraint, BucketLogsPermission, BucketType, BucketVersioningStatus, ChecksumAlgorithm, ChecksumMode, ChecksumType, DataRedundancy, DeleteMarkerReplicationStatus, EncodingType, EncryptionType, Event, ExistingObjectReplicationStatus, ExpirationState, ExpirationStatus, FileHeaderInfo, FilterRuleName, IntelligentTieringAccessTier, IntelligentTieringStatus, InventoryConfigurationState, InventoryFormat, InventoryFrequency, InventoryIncludedObjectVersions, InventoryOptionalField, JSONType, LocationType, MetadataDirective, MetricsStatus, MFADelete, MFADeleteStatus, ObjectAttributes, ObjectCannedACL, ObjectLockEnabled, ObjectLockLegalHoldStatus, ObjectLockMode, ObjectLockRetentionMode, ObjectOwnership, ObjectStorageClass, ObjectVersionStorageClass, OptionalObjectAttributes, OwnerOverride, PartitionDateSource, Payer, Permission, Protocol, ReplicaModificationsStatus, ReplicationRuleStatus, ReplicationStatus, ReplicationTimeStatus, RequestCharged, RequestPayer, S3TablesBucketType, ServerSideEncryption, SessionMode, SseKmsEncryptedObjectsStatus, StorageClass, StorageClassAnalysisSchemaVersion, TableSseAlgorithm, TaggingDirective, Tier, TransitionDefaultMinimumObjectSize, TransitionStorageClass, Type } from "./enums";
2
+ import { AnalyticsS3ExportFileFormat, ArchiveStatus, BucketAbacStatus, BucketAccelerateStatus, BucketCannedACL, BucketLocationConstraint, BucketLogsPermission, BucketNamespace, BucketType, BucketVersioningStatus, ChecksumAlgorithm, ChecksumMode, ChecksumType, DataRedundancy, DeleteMarkerReplicationStatus, EncodingType, EncryptionType, Event, ExistingObjectReplicationStatus, ExpirationState, ExpirationStatus, FileHeaderInfo, FilterRuleName, IntelligentTieringAccessTier, IntelligentTieringStatus, InventoryConfigurationState, InventoryFormat, InventoryFrequency, InventoryIncludedObjectVersions, InventoryOptionalField, JSONType, LocationType, MetadataDirective, MetricsStatus, MFADelete, MFADeleteStatus, ObjectAttributes, ObjectCannedACL, ObjectLockEnabled, ObjectLockLegalHoldStatus, ObjectLockMode, ObjectLockRetentionMode, ObjectOwnership, ObjectStorageClass, ObjectVersionStorageClass, OptionalObjectAttributes, OwnerOverride, PartitionDateSource, Payer, Permission, Protocol, ReplicaModificationsStatus, ReplicationRuleStatus, ReplicationStatus, ReplicationTimeStatus, RequestCharged, RequestPayer, S3TablesBucketType, ServerSideEncryption, SessionMode, SseKmsEncryptedObjectsStatus, StorageClass, StorageClassAnalysisSchemaVersion, TableSseAlgorithm, TaggingDirective, Tier, TransitionDefaultMinimumObjectSize, TransitionStorageClass, Type } from "./enums";
3
3
  /**
4
4
  * <p>The ABAC status of the general purpose bucket. When ABAC is enabled for the general purpose bucket, you can use tags to manage access to the general purpose buckets as well as for cost tracking purposes. When ABAC is disabled for the general purpose buckets, you can only use tags for cost tracking purposes. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging.html">Using tags with S3 general purpose buckets</a>. </p>
5
5
  * @public
@@ -1718,6 +1718,25 @@ export interface CreateBucketRequest {
1718
1718
  * @public
1719
1719
  */
1720
1720
  ObjectOwnership?: ObjectOwnership | undefined;
1721
+ /**
1722
+ * <p>Specifies the namespace where you want to create your general purpose bucket. When you create a
1723
+ * general purpose bucket, you can choose to create a bucket in the shared global namespace or you can choose to
1724
+ * create a bucket in your account regional namespace. Your account regional namespace is a subdivision of
1725
+ * the global namespace that only your account can create buckets in. For more information on bucket
1726
+ * namespaces, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/gpbucketnamespaces.html">Namespaces for general purpose buckets</a>.</p>
1727
+ * <p>General purpose buckets in your account regional namespace must follow a specific naming convention. These
1728
+ * buckets consist of a bucket name prefix that you create, and a suffix that contains your 12-digit Amazon Web Services
1729
+ * Account ID, the Amazon Web Services Region code, and ends with <code>-an</code>. Bucket names must follow the format
1730
+ * <code>bucket-name-prefix-accountId-region-an</code> (for example,
1731
+ * <code>amzn-s3-demo-bucket-111122223333-us-west-2-an</code>). For information about bucket naming
1732
+ * restrictions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html#account-regional-naming-rules">Account regional namespace naming rules</a>
1733
+ * in the <i>Amazon S3 User Guide</i>.</p>
1734
+ * <note>
1735
+ * <p>This functionality is not supported for directory buckets.</p>
1736
+ * </note>
1737
+ * @public
1738
+ */
1739
+ BucketNamespace?: BucketNamespace | undefined;
1721
1740
  }
1722
1741
  /**
1723
1742
  * <p>
@@ -2742,7 +2761,10 @@ export interface CreateSessionOutput {
2742
2761
  export interface CreateSessionRequest {
2743
2762
  /**
2744
2763
  * <p>Specifies the mode of the session that will be created, either <code>ReadWrite</code> or
2745
- * <code>ReadOnly</code>. By default, a <code>ReadWrite</code> session is created. A
2764
+ * <code>ReadOnly</code>. If no session mode is specified, the default behavior attempts to create
2765
+ * a session with the maximum allowable privilege. It will first attempt to create a
2766
+ * <code>ReadWrite</code> session, and if that is not allowed by permissions, it will attempt to create a
2767
+ * <code>ReadOnly</code> session. If neither session type is allowed, the request will return an Access Denied error. A
2746
2768
  * <code>ReadWrite</code> session is capable of executing all the Zonal endpoint API operations on a directory bucket. A
2747
2769
  * <code>ReadOnly</code> session is constrained to execute the following Zonal endpoint API operations:
2748
2770
  * <code>GetObject</code>, <code>HeadObject</code>, <code>ListObjectsV2</code>,
@@ -118,6 +118,12 @@ export declare const BucketCannedACL: {
118
118
  };
119
119
  export type BucketCannedACL =
120
120
  (typeof BucketCannedACL)[keyof typeof BucketCannedACL];
121
+ export declare const BucketNamespace: {
122
+ readonly ACCOUNT_REGIONAL: "account-regional";
123
+ readonly GLOBAL: "global";
124
+ };
125
+ export type BucketNamespace =
126
+ (typeof BucketNamespace)[keyof typeof BucketNamespace];
121
127
  export declare const DataRedundancy: {
122
128
  readonly SingleAvailabilityZone: "SingleAvailabilityZone";
123
129
  readonly SingleLocalZone: "SingleLocalZone";
@@ -7,6 +7,7 @@ import {
7
7
  BucketCannedACL,
8
8
  BucketLocationConstraint,
9
9
  BucketLogsPermission,
10
+ BucketNamespace,
10
11
  BucketType,
11
12
  BucketVersioningStatus,
12
13
  ChecksumAlgorithm,
@@ -262,6 +263,7 @@ export interface CreateBucketRequest {
262
263
  GrantWriteACP?: string | undefined;
263
264
  ObjectLockEnabledForBucket?: boolean | undefined;
264
265
  ObjectOwnership?: ObjectOwnership | undefined;
266
+ BucketNamespace?: BucketNamespace | undefined;
265
267
  }
266
268
  export interface MetadataTableEncryptionConfiguration {
267
269
  SseAlgorithm: TableSseAlgorithm | undefined;
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-s3",
3
3
  "description": "AWS SDK for JavaScript S3 Client for Node.js, Browser and React Native",
4
- "version": "3.1005.0",
4
+ "version": "3.1010.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:types' 'yarn:build:es' && yarn build:cjs",
7
7
  "build:cjs": "node ../../scripts/compilation/inline client-s3",
@@ -30,62 +30,62 @@
30
30
  "@aws-crypto/sha1-browser": "5.2.0",
31
31
  "@aws-crypto/sha256-browser": "5.2.0",
32
32
  "@aws-crypto/sha256-js": "5.2.0",
33
- "@aws-sdk/core": "^3.973.19",
34
- "@aws-sdk/credential-provider-node": "^3.972.19",
35
- "@aws-sdk/middleware-bucket-endpoint": "^3.972.7",
36
- "@aws-sdk/middleware-expect-continue": "^3.972.7",
37
- "@aws-sdk/middleware-flexible-checksums": "^3.973.5",
38
- "@aws-sdk/middleware-host-header": "^3.972.7",
39
- "@aws-sdk/middleware-location-constraint": "^3.972.7",
40
- "@aws-sdk/middleware-logger": "^3.972.7",
41
- "@aws-sdk/middleware-recursion-detection": "^3.972.7",
42
- "@aws-sdk/middleware-sdk-s3": "^3.972.19",
43
- "@aws-sdk/middleware-ssec": "^3.972.7",
44
- "@aws-sdk/middleware-user-agent": "^3.972.20",
45
- "@aws-sdk/region-config-resolver": "^3.972.7",
46
- "@aws-sdk/signature-v4-multi-region": "^3.996.7",
47
- "@aws-sdk/types": "^3.973.5",
48
- "@aws-sdk/util-endpoints": "^3.996.4",
49
- "@aws-sdk/util-user-agent-browser": "^3.972.7",
50
- "@aws-sdk/util-user-agent-node": "^3.973.5",
51
- "@smithy/config-resolver": "^4.4.10",
52
- "@smithy/core": "^3.23.9",
53
- "@smithy/eventstream-serde-browser": "^4.2.11",
54
- "@smithy/eventstream-serde-config-resolver": "^4.3.11",
55
- "@smithy/eventstream-serde-node": "^4.2.11",
56
- "@smithy/fetch-http-handler": "^5.3.13",
57
- "@smithy/hash-blob-browser": "^4.2.12",
58
- "@smithy/hash-node": "^4.2.11",
59
- "@smithy/hash-stream-node": "^4.2.11",
60
- "@smithy/invalid-dependency": "^4.2.11",
61
- "@smithy/md5-js": "^4.2.11",
62
- "@smithy/middleware-content-length": "^4.2.11",
63
- "@smithy/middleware-endpoint": "^4.4.23",
64
- "@smithy/middleware-retry": "^4.4.40",
65
- "@smithy/middleware-serde": "^4.2.12",
66
- "@smithy/middleware-stack": "^4.2.11",
67
- "@smithy/node-config-provider": "^4.3.11",
68
- "@smithy/node-http-handler": "^4.4.14",
69
- "@smithy/protocol-http": "^5.3.11",
70
- "@smithy/smithy-client": "^4.12.3",
71
- "@smithy/types": "^4.13.0",
72
- "@smithy/url-parser": "^4.2.11",
33
+ "@aws-sdk/core": "^3.973.20",
34
+ "@aws-sdk/credential-provider-node": "^3.972.21",
35
+ "@aws-sdk/middleware-bucket-endpoint": "^3.972.8",
36
+ "@aws-sdk/middleware-expect-continue": "^3.972.8",
37
+ "@aws-sdk/middleware-flexible-checksums": "^3.974.0",
38
+ "@aws-sdk/middleware-host-header": "^3.972.8",
39
+ "@aws-sdk/middleware-location-constraint": "^3.972.8",
40
+ "@aws-sdk/middleware-logger": "^3.972.8",
41
+ "@aws-sdk/middleware-recursion-detection": "^3.972.8",
42
+ "@aws-sdk/middleware-sdk-s3": "^3.972.20",
43
+ "@aws-sdk/middleware-ssec": "^3.972.8",
44
+ "@aws-sdk/middleware-user-agent": "^3.972.21",
45
+ "@aws-sdk/region-config-resolver": "^3.972.8",
46
+ "@aws-sdk/signature-v4-multi-region": "^3.996.8",
47
+ "@aws-sdk/types": "^3.973.6",
48
+ "@aws-sdk/util-endpoints": "^3.996.5",
49
+ "@aws-sdk/util-user-agent-browser": "^3.972.8",
50
+ "@aws-sdk/util-user-agent-node": "^3.973.7",
51
+ "@smithy/config-resolver": "^4.4.11",
52
+ "@smithy/core": "^3.23.11",
53
+ "@smithy/eventstream-serde-browser": "^4.2.12",
54
+ "@smithy/eventstream-serde-config-resolver": "^4.3.12",
55
+ "@smithy/eventstream-serde-node": "^4.2.12",
56
+ "@smithy/fetch-http-handler": "^5.3.15",
57
+ "@smithy/hash-blob-browser": "^4.2.13",
58
+ "@smithy/hash-node": "^4.2.12",
59
+ "@smithy/hash-stream-node": "^4.2.12",
60
+ "@smithy/invalid-dependency": "^4.2.12",
61
+ "@smithy/md5-js": "^4.2.12",
62
+ "@smithy/middleware-content-length": "^4.2.12",
63
+ "@smithy/middleware-endpoint": "^4.4.25",
64
+ "@smithy/middleware-retry": "^4.4.42",
65
+ "@smithy/middleware-serde": "^4.2.14",
66
+ "@smithy/middleware-stack": "^4.2.12",
67
+ "@smithy/node-config-provider": "^4.3.12",
68
+ "@smithy/node-http-handler": "^4.4.16",
69
+ "@smithy/protocol-http": "^5.3.12",
70
+ "@smithy/smithy-client": "^4.12.5",
71
+ "@smithy/types": "^4.13.1",
72
+ "@smithy/url-parser": "^4.2.12",
73
73
  "@smithy/util-base64": "^4.3.2",
74
74
  "@smithy/util-body-length-browser": "^4.2.2",
75
75
  "@smithy/util-body-length-node": "^4.2.3",
76
- "@smithy/util-defaults-mode-browser": "^4.3.39",
77
- "@smithy/util-defaults-mode-node": "^4.2.42",
78
- "@smithy/util-endpoints": "^3.3.2",
79
- "@smithy/util-middleware": "^4.2.11",
80
- "@smithy/util-retry": "^4.2.11",
81
- "@smithy/util-stream": "^4.5.17",
76
+ "@smithy/util-defaults-mode-browser": "^4.3.41",
77
+ "@smithy/util-defaults-mode-node": "^4.2.44",
78
+ "@smithy/util-endpoints": "^3.3.3",
79
+ "@smithy/util-middleware": "^4.2.12",
80
+ "@smithy/util-retry": "^4.2.12",
81
+ "@smithy/util-stream": "^4.5.19",
82
82
  "@smithy/util-utf8": "^4.2.2",
83
- "@smithy/util-waiter": "^4.2.11",
83
+ "@smithy/util-waiter": "^4.2.13",
84
84
  "tslib": "^2.6.2"
85
85
  },
86
86
  "devDependencies": {
87
- "@aws-sdk/signature-v4-crt": "3.1005.0",
88
- "@smithy/snapshot-testing": "^1.0.10",
87
+ "@aws-sdk/signature-v4-crt": "3.1010.0",
88
+ "@smithy/snapshot-testing": "^2.0.2",
89
89
  "@tsconfig/node20": "20.1.8",
90
90
  "@types/node": "^20.14.8",
91
91
  "concurrently": "7.0.0",
@@ -42,8 +42,9 @@ Parameters</a>
42
42
  </ul>
43
43
 
44
44
  ## Installing
45
- To install this package, simply type add or install @aws-sdk/client-ses
46
- using your favorite package manager:
45
+
46
+ To install this package, use the CLI of your favorite package manager:
47
+
47
48
  - `npm install @aws-sdk/client-ses`
48
49
  - `yarn add @aws-sdk/client-ses`
49
50
  - `pnpm add @aws-sdk/client-ses`
@@ -68,15 +69,15 @@ import { SESClient, ListIdentitiesCommand } from "@aws-sdk/client-ses";
68
69
 
69
70
  ### Usage
70
71
 
71
- To send a request, you:
72
+ To send a request:
72
73
 
73
- - Initiate client with configuration (e.g. credentials, region).
74
- - Initiate command with input parameters.
75
- - Call `send` operation on client with command object as input.
76
- - If you are using a custom http handler, you may call `destroy()` to close open connections.
74
+ - Instantiate a client with configuration (e.g. credentials, region).
75
+ - See [docs/CLIENTS](https://github.com/aws/aws-sdk-js-v3/blob/main/supplemental-docs/CLIENTS.md) for configuration details.
76
+ - See [@aws-sdk/config](https://github.com/aws/aws-sdk-js-v3/blob/main/packages/config/README.md) for additional options.
77
+ - Instantiate a command with input parameters.
78
+ - Call the `send` operation on the client, providing the command object as input.
77
79
 
78
80
  ```js
79
- // a client can be shared by different commands.
80
81
  const client = new SESClient({ region: "REGION" });
81
82
 
82
83
  const params = { /** input parameters */ };
@@ -85,7 +86,7 @@ const command = new ListIdentitiesCommand(params);
85
86
 
86
87
  #### Async/await
87
88
 
88
- We recommend using [await](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/await)
89
+ We recommend using the [await](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/await)
89
90
  operator to wait for the promise returned by send operation as follows:
90
91
 
91
92
  ```js
@@ -100,26 +101,9 @@ try {
100
101
  }
101
102
  ```
102
103
 
103
- Async-await is clean, concise, intuitive, easy to debug and has better error handling
104
- as compared to using Promise chains or callbacks.
105
-
106
104
  #### Promises
107
105
 
108
- You can also use [Promise chaining](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Using_promises#chaining)
109
- to execute send operation.
110
-
111
- ```js
112
- client.send(command).then(
113
- (data) => {
114
- // process data.
115
- },
116
- (error) => {
117
- // error handling.
118
- }
119
- );
120
- ```
121
-
122
- Promises can also be called using `.catch()` and `.finally()` as follows:
106
+ You can also use [Promise chaining](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Using_promises#chaining).
123
107
 
124
108
  ```js
125
109
  client
@@ -135,27 +119,21 @@ client
135
119
  });
136
120
  ```
137
121
 
138
- #### Callbacks
139
-
140
- We do not recommend using callbacks because of [callback hell](http://callbackhell.com/),
141
- but they are supported by the send operation.
122
+ #### Aggregated client
142
123
 
143
- ```js
144
- // callbacks.
145
- client.send(command, (err, data) => {
146
- // process err and data.
147
- });
148
- ```
124
+ The aggregated client class is exported from the same package, but without the "Client" suffix.
149
125
 
150
- #### v2 compatible style
126
+ `SES` extends `SESClient` and additionally supports all operations, waiters, and paginators as methods.
127
+ This style may be familiar to you from the AWS SDK for JavaScript v2.
151
128
 
152
- The client can also send requests using v2 compatible style.
153
- However, it results in a bigger bundle size and may be dropped in next major version. More details in the blog post
154
- on [modular packages in AWS SDK for JavaScript](https://aws.amazon.com/blogs/developer/modular-packages-in-aws-sdk-for-javascript/)
129
+ If you are bundling the AWS SDK, we recommend using only the bare-bones client (`SESClient`).
130
+ More details are in the blog post on
131
+ [modular packages in AWS SDK for JavaScript](https://aws.amazon.com/blogs/developer/modular-packages-in-aws-sdk-for-javascript/).
155
132
 
156
133
  ```ts
157
- import * as AWS from "@aws-sdk/client-ses";
158
- const client = new AWS.SES({ region: "REGION" });
134
+ import { SES } from "@aws-sdk/client-ses";
135
+
136
+ const client = new SES({ region: "REGION" });
159
137
 
160
138
  // async/await.
161
139
  try {
@@ -175,7 +153,7 @@ client
175
153
  // error handling.
176
154
  });
177
155
 
178
- // callbacks.
156
+ // callbacks (not recommended).
179
157
  client.listIdentities(params, (err, data) => {
180
158
  // process err and data.
181
159
  });
@@ -203,12 +181,14 @@ try {
203
181
  }
204
182
  ```
205
183
 
184
+ See also [docs/ERROR_HANDLING](https://github.com/aws/aws-sdk-js-v3/blob/main/supplemental-docs/ERROR_HANDLING.md).
185
+
206
186
  ## Getting Help
207
187
 
208
188
  Please use these community resources for getting help.
209
- We use the GitHub issues for tracking bugs and feature requests, but have limited bandwidth to address them.
189
+ We use GitHub issues for tracking bugs and feature requests, but have limited bandwidth to address them.
210
190
 
211
- - Visit [Developer Guide](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/welcome.html)
191
+ - Visit the [Developer Guide](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/welcome.html)
212
192
  or [API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/index.html).
213
193
  - Check out the blog posts tagged with [`aws-sdk-js`](https://aws.amazon.com/blogs/developer/tag/aws-sdk-js/)
214
194
  on AWS Developer Blog.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-ses",
3
3
  "description": "AWS SDK for JavaScript Ses Client for Node.js, Browser and React Native",
4
- "version": "3.1005.0",
4
+ "version": "3.1010.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:types' 'yarn:build:es' && yarn build:cjs",
7
7
  "build:cjs": "node ../../scripts/compilation/inline client-ses",
@@ -23,43 +23,43 @@
23
23
  "dependencies": {
24
24
  "@aws-crypto/sha256-browser": "5.2.0",
25
25
  "@aws-crypto/sha256-js": "5.2.0",
26
- "@aws-sdk/core": "^3.973.19",
27
- "@aws-sdk/credential-provider-node": "^3.972.19",
28
- "@aws-sdk/middleware-host-header": "^3.972.7",
29
- "@aws-sdk/middleware-logger": "^3.972.7",
30
- "@aws-sdk/middleware-recursion-detection": "^3.972.7",
31
- "@aws-sdk/middleware-user-agent": "^3.972.20",
32
- "@aws-sdk/region-config-resolver": "^3.972.7",
33
- "@aws-sdk/types": "^3.973.5",
34
- "@aws-sdk/util-endpoints": "^3.996.4",
35
- "@aws-sdk/util-user-agent-browser": "^3.972.7",
36
- "@aws-sdk/util-user-agent-node": "^3.973.5",
37
- "@smithy/config-resolver": "^4.4.10",
38
- "@smithy/core": "^3.23.9",
39
- "@smithy/fetch-http-handler": "^5.3.13",
40
- "@smithy/hash-node": "^4.2.11",
41
- "@smithy/invalid-dependency": "^4.2.11",
42
- "@smithy/middleware-content-length": "^4.2.11",
43
- "@smithy/middleware-endpoint": "^4.4.23",
44
- "@smithy/middleware-retry": "^4.4.40",
45
- "@smithy/middleware-serde": "^4.2.12",
46
- "@smithy/middleware-stack": "^4.2.11",
47
- "@smithy/node-config-provider": "^4.3.11",
48
- "@smithy/node-http-handler": "^4.4.14",
49
- "@smithy/protocol-http": "^5.3.11",
50
- "@smithy/smithy-client": "^4.12.3",
51
- "@smithy/types": "^4.13.0",
52
- "@smithy/url-parser": "^4.2.11",
26
+ "@aws-sdk/core": "^3.973.20",
27
+ "@aws-sdk/credential-provider-node": "^3.972.21",
28
+ "@aws-sdk/middleware-host-header": "^3.972.8",
29
+ "@aws-sdk/middleware-logger": "^3.972.8",
30
+ "@aws-sdk/middleware-recursion-detection": "^3.972.8",
31
+ "@aws-sdk/middleware-user-agent": "^3.972.21",
32
+ "@aws-sdk/region-config-resolver": "^3.972.8",
33
+ "@aws-sdk/types": "^3.973.6",
34
+ "@aws-sdk/util-endpoints": "^3.996.5",
35
+ "@aws-sdk/util-user-agent-browser": "^3.972.8",
36
+ "@aws-sdk/util-user-agent-node": "^3.973.7",
37
+ "@smithy/config-resolver": "^4.4.11",
38
+ "@smithy/core": "^3.23.11",
39
+ "@smithy/fetch-http-handler": "^5.3.15",
40
+ "@smithy/hash-node": "^4.2.12",
41
+ "@smithy/invalid-dependency": "^4.2.12",
42
+ "@smithy/middleware-content-length": "^4.2.12",
43
+ "@smithy/middleware-endpoint": "^4.4.25",
44
+ "@smithy/middleware-retry": "^4.4.42",
45
+ "@smithy/middleware-serde": "^4.2.14",
46
+ "@smithy/middleware-stack": "^4.2.12",
47
+ "@smithy/node-config-provider": "^4.3.12",
48
+ "@smithy/node-http-handler": "^4.4.16",
49
+ "@smithy/protocol-http": "^5.3.12",
50
+ "@smithy/smithy-client": "^4.12.5",
51
+ "@smithy/types": "^4.13.1",
52
+ "@smithy/url-parser": "^4.2.12",
53
53
  "@smithy/util-base64": "^4.3.2",
54
54
  "@smithy/util-body-length-browser": "^4.2.2",
55
55
  "@smithy/util-body-length-node": "^4.2.3",
56
- "@smithy/util-defaults-mode-browser": "^4.3.39",
57
- "@smithy/util-defaults-mode-node": "^4.2.42",
58
- "@smithy/util-endpoints": "^3.3.2",
59
- "@smithy/util-middleware": "^4.2.11",
60
- "@smithy/util-retry": "^4.2.11",
56
+ "@smithy/util-defaults-mode-browser": "^4.3.41",
57
+ "@smithy/util-defaults-mode-node": "^4.2.44",
58
+ "@smithy/util-endpoints": "^3.3.3",
59
+ "@smithy/util-middleware": "^4.2.12",
60
+ "@smithy/util-retry": "^4.2.12",
61
61
  "@smithy/util-utf8": "^4.2.2",
62
- "@smithy/util-waiter": "^4.2.11",
62
+ "@smithy/util-waiter": "^4.2.13",
63
63
  "tslib": "^2.6.2"
64
64
  },
65
65
  "devDependencies": {
@@ -46,8 +46,9 @@ Reference</a>
46
46
  </ul>
47
47
 
48
48
  ## Installing
49
- To install this package, simply type add or install @aws-sdk/client-ssm
50
- using your favorite package manager:
49
+
50
+ To install this package, use the CLI of your favorite package manager:
51
+
51
52
  - `npm install @aws-sdk/client-ssm`
52
53
  - `yarn add @aws-sdk/client-ssm`
53
54
  - `pnpm add @aws-sdk/client-ssm`
@@ -72,15 +73,15 @@ import { SSMClient, ListNodesCommand } from "@aws-sdk/client-ssm";
72
73
 
73
74
  ### Usage
74
75
 
75
- To send a request, you:
76
+ To send a request:
76
77
 
77
- - Initiate client with configuration (e.g. credentials, region).
78
- - Initiate command with input parameters.
79
- - Call `send` operation on client with command object as input.
80
- - If you are using a custom http handler, you may call `destroy()` to close open connections.
78
+ - Instantiate a client with configuration (e.g. credentials, region).
79
+ - See [docs/CLIENTS](https://github.com/aws/aws-sdk-js-v3/blob/main/supplemental-docs/CLIENTS.md) for configuration details.
80
+ - See [@aws-sdk/config](https://github.com/aws/aws-sdk-js-v3/blob/main/packages/config/README.md) for additional options.
81
+ - Instantiate a command with input parameters.
82
+ - Call the `send` operation on the client, providing the command object as input.
81
83
 
82
84
  ```js
83
- // a client can be shared by different commands.
84
85
  const client = new SSMClient({ region: "REGION" });
85
86
 
86
87
  const params = { /** input parameters */ };
@@ -89,7 +90,7 @@ const command = new ListNodesCommand(params);
89
90
 
90
91
  #### Async/await
91
92
 
92
- We recommend using [await](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/await)
93
+ We recommend using the [await](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/await)
93
94
  operator to wait for the promise returned by send operation as follows:
94
95
 
95
96
  ```js
@@ -104,26 +105,9 @@ try {
104
105
  }
105
106
  ```
106
107
 
107
- Async-await is clean, concise, intuitive, easy to debug and has better error handling
108
- as compared to using Promise chains or callbacks.
109
-
110
108
  #### Promises
111
109
 
112
- You can also use [Promise chaining](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Using_promises#chaining)
113
- to execute send operation.
114
-
115
- ```js
116
- client.send(command).then(
117
- (data) => {
118
- // process data.
119
- },
120
- (error) => {
121
- // error handling.
122
- }
123
- );
124
- ```
125
-
126
- Promises can also be called using `.catch()` and `.finally()` as follows:
110
+ You can also use [Promise chaining](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Using_promises#chaining).
127
111
 
128
112
  ```js
129
113
  client
@@ -139,27 +123,21 @@ client
139
123
  });
140
124
  ```
141
125
 
142
- #### Callbacks
143
-
144
- We do not recommend using callbacks because of [callback hell](http://callbackhell.com/),
145
- but they are supported by the send operation.
126
+ #### Aggregated client
146
127
 
147
- ```js
148
- // callbacks.
149
- client.send(command, (err, data) => {
150
- // process err and data.
151
- });
152
- ```
128
+ The aggregated client class is exported from the same package, but without the "Client" suffix.
153
129
 
154
- #### v2 compatible style
130
+ `SSM` extends `SSMClient` and additionally supports all operations, waiters, and paginators as methods.
131
+ This style may be familiar to you from the AWS SDK for JavaScript v2.
155
132
 
156
- The client can also send requests using v2 compatible style.
157
- However, it results in a bigger bundle size and may be dropped in next major version. More details in the blog post
158
- on [modular packages in AWS SDK for JavaScript](https://aws.amazon.com/blogs/developer/modular-packages-in-aws-sdk-for-javascript/)
133
+ If you are bundling the AWS SDK, we recommend using only the bare-bones client (`SSMClient`).
134
+ More details are in the blog post on
135
+ [modular packages in AWS SDK for JavaScript](https://aws.amazon.com/blogs/developer/modular-packages-in-aws-sdk-for-javascript/).
159
136
 
160
137
  ```ts
161
- import * as AWS from "@aws-sdk/client-ssm";
162
- const client = new AWS.SSM({ region: "REGION" });
138
+ import { SSM } from "@aws-sdk/client-ssm";
139
+
140
+ const client = new SSM({ region: "REGION" });
163
141
 
164
142
  // async/await.
165
143
  try {
@@ -179,7 +157,7 @@ client
179
157
  // error handling.
180
158
  });
181
159
 
182
- // callbacks.
160
+ // callbacks (not recommended).
183
161
  client.listNodes(params, (err, data) => {
184
162
  // process err and data.
185
163
  });
@@ -207,12 +185,14 @@ try {
207
185
  }
208
186
  ```
209
187
 
188
+ See also [docs/ERROR_HANDLING](https://github.com/aws/aws-sdk-js-v3/blob/main/supplemental-docs/ERROR_HANDLING.md).
189
+
210
190
  ## Getting Help
211
191
 
212
192
  Please use these community resources for getting help.
213
- We use the GitHub issues for tracking bugs and feature requests, but have limited bandwidth to address them.
193
+ We use GitHub issues for tracking bugs and feature requests, but have limited bandwidth to address them.
214
194
 
215
- - Visit [Developer Guide](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/welcome.html)
195
+ - Visit the [Developer Guide](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/welcome.html)
216
196
  or [API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/index.html).
217
197
  - Check out the blog posts tagged with [`aws-sdk-js`](https://aws.amazon.com/blogs/developer/tag/aws-sdk-js/)
218
198
  on AWS Developer Blog.