diff -pruN 1.10.0-1/CHANGELOG.md 1.11.0-1/CHANGELOG.md --- 1.10.0-1/CHANGELOG.md 2025-05-12 09:35:01.000000000 +0000 +++ 1.11.0-1/CHANGELOG.md 2025-08-11 10:03:27.000000000 +0000 @@ -2,6 +2,16 @@ ## NOT RELEASED +## 1.11.0 + +### Added + +- AWS api-change: Rework regions configuration + +### Changed + +- AWS enhancement: Documentation updates. + ## 1.10.0 ### Added diff -pruN 1.10.0-1/composer.json 1.11.0-1/composer.json --- 1.10.0-1/composer.json 2025-05-12 09:35:01.000000000 +0000 +++ 1.11.0-1/composer.json 2025-08-11 10:03:27.000000000 +0000 @@ -28,7 +28,7 @@ }, "extra": { "branch-alias": { - "dev-master": "1.10-dev" + "dev-master": "1.11-dev" } } } diff -pruN 1.10.0-1/debian/changelog 1.11.0-1/debian/changelog --- 1.10.0-1/debian/changelog 2025-05-12 16:42:44.000000000 +0000 +++ 1.11.0-1/debian/changelog 2025-08-12 11:20:50.000000000 +0000 @@ -1,3 +1,12 @@ +php-async-aws-sns (1.11.0-1) unstable; urgency=medium + + * Upload to unstable now that Trixie has been released + + [ Jérémy Derussé ] + * prepare next release (#1932) + + -- David Prévot Tue, 12 Aug 2025 13:20:50 +0200 + php-async-aws-sns (1.10.0-1) experimental; urgency=medium * Upload to experimental during the freeze diff -pruN 1.10.0-1/src/Exception/FilterPolicyLimitExceededException.php 1.11.0-1/src/Exception/FilterPolicyLimitExceededException.php --- 1.10.0-1/src/Exception/FilterPolicyLimitExceededException.php 2025-05-12 09:35:01.000000000 +0000 +++ 1.11.0-1/src/Exception/FilterPolicyLimitExceededException.php 2025-08-11 10:03:27.000000000 +0000 @@ -6,7 +6,7 @@ use AsyncAws\Core\Exception\Http\ClientE /** * Indicates that the number of filter polices in your Amazon Web Services account exceeds the limit. To add more filter - * polices, submit an Amazon SNS Limit Increase case in the Amazon Web Services Support Center. + * polices, submit an Amazon SNS Limit Increase case in the Amazon Web ServicesSupport Center. */ final class FilterPolicyLimitExceededException extends ClientException { diff -pruN 1.10.0-1/src/Exception/TooManyEntriesInBatchRequestException.php 1.11.0-1/src/Exception/TooManyEntriesInBatchRequestException.php --- 1.10.0-1/src/Exception/TooManyEntriesInBatchRequestException.php 2025-05-12 09:35:01.000000000 +0000 +++ 1.11.0-1/src/Exception/TooManyEntriesInBatchRequestException.php 2025-08-11 10:03:27.000000000 +0000 @@ -5,7 +5,7 @@ namespace AsyncAws\Sns\Exception; use AsyncAws\Core\Exception\Http\ClientException; /** - * The batch request contains more entries than permissible. + * The batch request contains more entries than permissible (more than 10). */ final class TooManyEntriesInBatchRequestException extends ClientException { diff -pruN 1.10.0-1/src/Input/CreateTopicInput.php 1.11.0-1/src/Input/CreateTopicInput.php --- 1.10.0-1/src/Input/CreateTopicInput.php 2025-05-12 09:35:01.000000000 +0000 +++ 1.11.0-1/src/Input/CreateTopicInput.php 2025-08-11 10:03:27.000000000 +0000 @@ -35,31 +35,84 @@ final class CreateTopicInput extends Inp * * - `DeliveryPolicy` – The policy that defines how Amazon SNS retries failed deliveries to HTTP/S endpoints. * - `DisplayName` – The display name to use for a topic with SMS subscriptions. - * - `FifoTopic` – Set to true to create a FIFO topic. * - `Policy` – The policy that defines who can access your topic. By default, only the topic owner can publish or * subscribe to the topic. - * - `SignatureVersion` – The signature version corresponds to the hashing algorithm used while creating the signature - * of the notifications, subscription confirmations, or unsubscribe confirmation messages sent by Amazon SNS. By - * default, `SignatureVersion` is set to `1`. * - `TracingConfig` – Tracing mode of an Amazon SNS topic. By default `TracingConfig` is set to `PassThrough`, and * the topic passes through the tracing header it receives from an Amazon SNS publisher to its subscriptions. If set * to `Active`, Amazon SNS will vend X-Ray segment data to topic owner account if the sampled flag in the tracing * header is true. This is only supported on standard topics. + * - HTTP * - * The following attribute applies only to server-side encryption [^1]: + * - `HTTPSuccessFeedbackRoleArn` – Indicates successful message delivery status for an Amazon SNS topic that is + * subscribed to an HTTP endpoint. + * - `HTTPSuccessFeedbackSampleRate` – Indicates percentage of successful messages to sample for an Amazon SNS topic + * that is subscribed to an HTTP endpoint. + * - `HTTPFailureFeedbackRoleArn` – Indicates failed message delivery status for an Amazon SNS topic that is + * subscribed to an HTTP endpoint. + * + * - Amazon Data Firehose + * + * - `FirehoseSuccessFeedbackRoleArn` – Indicates successful message delivery status for an Amazon SNS topic that is + * subscribed to an Amazon Data Firehose endpoint. + * - `FirehoseSuccessFeedbackSampleRate` – Indicates percentage of successful messages to sample for an Amazon SNS + * topic that is subscribed to an Amazon Data Firehose endpoint. + * - `FirehoseFailureFeedbackRoleArn` – Indicates failed message delivery status for an Amazon SNS topic that is + * subscribed to an Amazon Data Firehose endpoint. + * + * - Lambda + * + * - `LambdaSuccessFeedbackRoleArn` – Indicates successful message delivery status for an Amazon SNS topic that is + * subscribed to an Lambda endpoint. + * - `LambdaSuccessFeedbackSampleRate` – Indicates percentage of successful messages to sample for an Amazon SNS + * topic that is subscribed to an Lambda endpoint. + * - `LambdaFailureFeedbackRoleArn` – Indicates failed message delivery status for an Amazon SNS topic that is + * subscribed to an Lambda endpoint. + * + * - Platform application endpoint + * + * - `ApplicationSuccessFeedbackRoleArn` – Indicates successful message delivery status for an Amazon SNS topic that + * is subscribed to a platform application endpoint. + * - `ApplicationSuccessFeedbackSampleRate` – Indicates percentage of successful messages to sample for an Amazon + * SNS topic that is subscribed to an platform application endpoint. + * - `ApplicationFailureFeedbackRoleArn` – Indicates failed message delivery status for an Amazon SNS topic that is + * subscribed to an platform application endpoint. + * + * > In addition to being able to configure topic attributes for message delivery status of notification messages sent + * > to Amazon SNS application endpoints, you can also configure application attributes for the delivery status of + * > push notification messages sent to push notification services. + * > + * > For example, For more information, see Using Amazon SNS Application Attributes for Message Delivery Status [^1]. + * + * - Amazon SQS + * + * - `SQSSuccessFeedbackRoleArn` – Indicates successful message delivery status for an Amazon SNS topic that is + * subscribed to an Amazon SQS endpoint. + * - `SQSSuccessFeedbackSampleRate` – Indicates percentage of successful messages to sample for an Amazon SNS topic + * that is subscribed to an Amazon SQS endpoint. + * - `SQSFailureFeedbackRoleArn` – Indicates failed message delivery status for an Amazon SNS topic that is + * subscribed to an Amazon SQS endpoint. + * + * + * > The SuccessFeedbackRoleArn and FailureFeedbackRoleArn attributes are used to give + * > Amazon SNS write access to use CloudWatch Logs on your behalf. The SuccessFeedbackSampleRate + * > attribute is for specifying the sample rate percentage (0-100) of successfully delivered messages. After you + * > configure the FailureFeedbackRoleArn attribute, then all failed message deliveries generate + * > CloudWatch Logs. + * + * The following attribute applies only to server-side encryption [^2]: * * - `KmsMasterKeyId` – The ID of an Amazon Web Services managed customer master key (CMK) for Amazon SNS or a custom - * CMK. For more information, see Key Terms [^2]. For more examples, see KeyId [^3] in the *Key Management Service API + * CMK. For more information, see Key Terms [^3]. For more examples, see KeyId [^4] in the *Key Management Service API * Reference*. * - * The following attributes apply only to FIFO topics [^4]: + * The following attributes apply only to FIFO topics [^5]: * * - `ArchivePolicy` – The policy that sets the retention period for messages stored in the message archive of an * Amazon SNS FIFO topic. * - `ContentBasedDeduplication` – Enables content-based deduplication for FIFO topics. * * - By default, `ContentBasedDeduplication` is set to `false`. If you create a FIFO topic and this attribute is - * `false`, you must specify a value for the `MessageDeduplicationId` parameter for the Publish [^5] action. + * `false`, you must specify a value for the `MessageDeduplicationId` parameter for the Publish [^6] action. * - When you set `ContentBasedDeduplication` to `true`, Amazon SNS uses a SHA-256 hash to generate the * `MessageDeduplicationId` using the body of the message (but not the attributes of the message). * @@ -75,14 +128,15 @@ final class CreateTopicInput extends Inp * comes first. * - `MessageGroup` – The scope of deduplication is within each individual message group, which enables higher * throughput per topic subject to regional quotas. For more information on quotas or to request an increase, see - * Amazon SNS service quotas [^6] in the Amazon Web Services General Reference. + * Amazon SNS service quotas [^7] in the Amazon Web Services General Reference. * - * [^1]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html - * [^2]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms - * [^3]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters - * [^4]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html - * [^5]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html - * [^6]: https://docs.aws.amazon.com/general/latest/gr/sns.html + * [^1]: https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html + * [^2]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html + * [^3]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms + * [^4]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters + * [^5]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html + * [^6]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html + * [^7]: https://docs.aws.amazon.com/general/latest/gr/sns.html * * @var array|null */ diff -pruN 1.10.0-1/src/Input/PublishInput.php 1.11.0-1/src/Input/PublishInput.php --- 1.10.0-1/src/Input/PublishInput.php 2025-05-12 09:35:01.000000000 +0000 +++ 1.11.0-1/src/Input/PublishInput.php 2025-08-11 10:03:27.000000000 +0000 @@ -148,12 +148,18 @@ final class PublishInput extends Input private $messageDeduplicationId; /** - * This parameter applies only to FIFO (first-in-first-out) topics. The `MessageGroupId` can contain up to 128 - * alphanumeric characters `(a-z, A-Z, 0-9)` and punctuation `(!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~)`. + * The `MessageGroupId` can contain up to 128 alphanumeric characters `(a-z, A-Z, 0-9)` and punctuation + * `(!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~)`. * - * The `MessageGroupId` is a tag that specifies that a message belongs to a specific message group. Messages that belong - * to the same message group are processed in a FIFO manner (however, messages in different message groups might be - * processed out of order). Every message must include a `MessageGroupId`. + * For FIFO topics: The `MessageGroupId` is a tag that specifies that a message belongs to a specific message group. + * Messages that belong to the same message group are processed in a FIFO manner (however, messages in different message + * groups might be processed out of order). Every message must include a `MessageGroupId`. + * + * For standard topics: The `MessageGroupId` is optional and is forwarded only to Amazon SQS standard subscriptions to + * activate fair queues [^1]. The `MessageGroupId` is not used for, or sent to, any other endpoint types. When provided, + * the same validation rules apply as for FIFO topics. + * + * [^1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-fair-queues.html * * @var string|null */ diff -pruN 1.10.0-1/src/Input/SubscribeInput.php 1.11.0-1/src/Input/SubscribeInput.php --- 1.10.0-1/src/Input/SubscribeInput.php 2025-05-12 09:35:01.000000000 +0000 +++ 1.11.0-1/src/Input/SubscribeInput.php 2025-08-11 10:03:27.000000000 +0000 @@ -32,7 +32,7 @@ final class SubscribeInput extends Input * - `sqs` – delivery of JSON-encoded message to an Amazon SQS queue * - `application` – delivery of JSON-encoded message to an EndpointArn for a mobile app and device * - `lambda` – delivery of JSON-encoded message to an Lambda function - * - `firehose` – delivery of JSON-encoded message to an Amazon Kinesis Data Firehose delivery stream. + * - `firehose` – delivery of JSON-encoded message to an Amazon Data Firehose delivery stream. * * @required * @@ -51,7 +51,7 @@ final class SubscribeInput extends Input * - For the `sqs` protocol, the endpoint is the ARN of an Amazon SQS queue. * - For the `application` protocol, the endpoint is the EndpointArn of a mobile app and device. * - For the `lambda` protocol, the endpoint is the ARN of an Lambda function. - * - For the `firehose` protocol, the endpoint is the ARN of an Amazon Kinesis Data Firehose delivery stream. + * - For the `firehose` protocol, the endpoint is the ARN of an Amazon Data Firehose delivery stream. * * @var string|null */ diff -pruN 1.10.0-1/src/SnsClient.php 1.11.0-1/src/SnsClient.php --- 1.10.0-1/src/SnsClient.php 2025-05-12 09:35:01.000000000 +0000 +++ 1.11.0-1/src/SnsClient.php 2025-08-11 10:03:27.000000000 +0000 @@ -6,7 +6,6 @@ use AsyncAws\Core\AbstractApi; use AsyncAws\Core\AwsError\AwsErrorFactoryInterface; use AsyncAws\Core\AwsError\XmlAwsErrorFactory; use AsyncAws\Core\Configuration; -use AsyncAws\Core\Exception\UnsupportedRegion; use AsyncAws\Core\RequestContext; use AsyncAws\Core\Result; use AsyncAws\Sns\Exception\AuthorizationErrorException; @@ -365,28 +364,35 @@ class SnsClient extends AbstractApi } /** - * Publishes up to ten messages to the specified topic. This is a batch version of `Publish`. For FIFO topics, multiple - * messages within a single batch are published in the order they are sent, and messages are deduplicated within the - * batch and across batches for 5 minutes. + * Publishes up to 10 messages to the specified topic in a single batch. This is a batch version of the `Publish` API. + * If you try to send more than 10 messages in a single batch request, you will receive a `TooManyEntriesInBatchRequest` + * exception. + * + * For FIFO topics, multiple messages within a single batch are published in the order they are sent, and messages are + * deduplicated within the batch and across batches for five minutes. * * The result of publishing each message is reported individually in the response. Because the batch request can result * in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns - * an HTTP status code of `200`. + * an HTTP status code of 200. * * The maximum allowed individual message size and the maximum total payload size (the sum of the individual lengths of * all of the batched messages) are both 256 KB (262,144 bytes). * + * ! The `PublishBatch` API can send up to 10 messages at a time. If you attempt to send more than 10 messages in one + * ! request, you will encounter a `TooManyEntriesInBatchRequest` exception. In such cases, split your messages into + * ! multiple requests, each containing no more than 10 messages. + * * Some actions take lists of parameters. These lists are specified using the `param.n` notation. Values of `n` are - * integers starting from 1. For example, a parameter list with two elements looks like this: + * integers starting from **1**. For example, a parameter list with two elements looks like this: * - * &AttributeName.1=first + * `&AttributeName.1=first` * - * &AttributeName.2=second + * `&AttributeName.2=second` * * If you send a batch message to a topic, Amazon SNS publishes the batch message to each endpoint that is subscribed to * the topic. The format of the batch message depends on the notification protocol for each subscribed endpoint. * - * When a `messageId` is returned, the batch message is saved and Amazon SNS immediately delivers the message to + * When a `messageId` is returned, the batch message is saved, and Amazon SNS immediately delivers the message to * subscribers. * * @see https://docs.aws.amazon.com/sns/latest/api/API_PublishBatch.html @@ -503,9 +509,6 @@ class SnsClient extends AbstractApi * delivered to the endpoint, so that the endpoint owner can easily resubscribe to the topic if the `Unsubscribe` * request was unintended. * - * > Amazon SQS queue subscriptions require authentication for deletion. Only the owner of the subscription, or the - * > owner of the topic can unsubscribe using the required Amazon Web Services signature. - * * This action is throttled at 100 transactions per second (TPS). * * @see https://docs.aws.amazon.com/sns/latest/api/API_Unsubscribe.html @@ -548,44 +551,6 @@ class SnsClient extends AbstractApi } switch ($region) { - case 'af-south-1': - case 'ap-east-1': - case 'ap-northeast-1': - case 'ap-northeast-2': - case 'ap-northeast-3': - case 'ap-south-1': - case 'ap-south-2': - case 'ap-southeast-1': - case 'ap-southeast-2': - case 'ap-southeast-3': - case 'ap-southeast-4': - case 'ap-southeast-5': - case 'ap-southeast-7': - case 'ca-central-1': - case 'ca-west-1': - case 'eu-central-1': - case 'eu-central-2': - case 'eu-north-1': - case 'eu-south-1': - case 'eu-south-2': - case 'eu-west-1': - case 'eu-west-2': - case 'eu-west-3': - case 'il-central-1': - case 'me-central-1': - case 'me-south-1': - case 'mx-central-1': - case 'sa-east-1': - case 'us-east-1': - case 'us-east-2': - case 'us-west-1': - case 'us-west-2': - return [ - 'endpoint' => "https://sns.$region.amazonaws.com", - 'signRegion' => $region, - 'signService' => 'sns', - 'signVersions' => ['v4'], - ]; case 'cn-north-1': case 'cn-northwest-1': return [ @@ -630,7 +595,6 @@ class SnsClient extends AbstractApi 'signVersions' => ['v4'], ]; case 'fips-us-gov-east-1': - case 'us-gov-east-1': return [ 'endpoint' => 'https://sns.us-gov-east-1.amazonaws.com', 'signRegion' => 'us-gov-east-1', @@ -638,7 +602,6 @@ class SnsClient extends AbstractApi 'signVersions' => ['v4'], ]; case 'fips-us-gov-west-1': - case 'us-gov-west-1': return [ 'endpoint' => 'https://sns.us-gov-west-1.amazonaws.com', 'signRegion' => 'us-gov-west-1', @@ -677,6 +640,11 @@ class SnsClient extends AbstractApi ]; } - throw new UnsupportedRegion(\sprintf('The region "%s" is not supported by "Sns".', $region)); + return [ + 'endpoint' => "https://sns.$region.amazonaws.com", + 'signRegion' => $region, + 'signService' => 'sns', + 'signVersions' => ['v4'], + ]; } } diff -pruN 1.10.0-1/src/ValueObject/PublishBatchRequestEntry.php 1.11.0-1/src/ValueObject/PublishBatchRequestEntry.php --- 1.10.0-1/src/ValueObject/PublishBatchRequestEntry.php 2025-05-12 09:35:01.000000000 +0000 +++ 1.11.0-1/src/ValueObject/PublishBatchRequestEntry.php 2025-08-11 10:03:27.000000000 +0000 @@ -43,8 +43,8 @@ final class PublishBatchRequestEntry * - be a syntactically valid JSON object; and * - contain at least a top-level JSON key of "default" with a value that is a string. * - * You can define other top-level keys that define the message you want to send to a specific transport protocol (e.g. - * http). + * You can define other top-level keys that define the message you want to send to a specific transport protocol (for + * example, http). * * @var string|null */ @@ -103,23 +103,22 @@ final class PublishBatchRequestEntry private $messageDeduplicationId; /** - * This parameter applies only to FIFO (first-in-first-out) topics. - * - * The tag that specifies that a message belongs to a specific message group. Messages that belong to the same message - * group are processed in a FIFO manner (however, messages in different message groups might be processed out of order). - * To interleave multiple ordered streams within a single topic, use `MessageGroupId` values (for example, session data - * for multiple users). In this scenario, multiple consumers can process the topic, but the session data of each user is - * processed in a FIFO fashion. + * FIFO topics: The tag that specifies that a message belongs to a specific message group. Messages that belong to the + * same message group are processed in a FIFO manner (however, messages in different message groups might be processed + * out of order). To interleave multiple ordered streams within a single topic, use `MessageGroupId` values (for + * example, session data for multiple users). In this scenario, multiple consumers can process the topic, but the + * session data of each user is processed in a FIFO fashion. You must associate a non-empty `MessageGroupId` with a + * message. If you do not provide a `MessageGroupId`, the action fails. * - * You must associate a non-empty `MessageGroupId` with a message. If you don't provide a `MessageGroupId`, the action - * fails. + * Standard topics: The `MessageGroupId` is optional and is forwarded only to Amazon SQS standard subscriptions to + * activate fair queues [^1]. The `MessageGroupId` is not used for, or sent to, any other endpoint types. * * The length of `MessageGroupId` is 128 characters. * * `MessageGroupId` can contain alphanumeric characters `(a-z, A-Z, 0-9)` and punctuation * `(!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~)`. * - * ! `MessageGroupId` is required for FIFO topics. You can't use it for standard topics. + * [^1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-fair-queues.html * * @var string|null */