feat(idempotency): Add support for ReturnValuesOnConditionCheckFailure in Idempotency.

[phipag]

Issue #, if available: #1784

Description of changes:

This feature avoids redundant DynamoDB calls in the Idempotency utility by making use of the ReturnValuesOnConditionCheckFailure option in the AWS SDK.

Instead of re-fetching a data record from the persistence store when a IdempotencyItemAlreadyExistsException is thrown, it attaches the offending data record to the exception so that it can be directly returned to the caller without making another DynamoDB call.

Note: In addition to unit tests, I ran E2E tests as well. Until E2E tests are restored in GitHub workflows, here is the output from running in my AWS account.

❯ mvn -Pe2e -B verify --file powertools-e2e-tests/pom.xml -Dtest="IdempotencyE2ET.java"
...
20:49:11.010 [main] INFO  software.amazon.lambda.powertools.testutils.Infrastructure - Uploading asset 839b70aab886d0655a55d0cd5db0219df16a020b1bdbcf192a3cfde01ca214d7.jar to cdk-hnb659fds-assets-********-eu-west-1
20:49:15.632 [main] INFO  software.amazon.lambda.powertools.testutils.Infrastructure - Deploying 'IdempotencyE2ET-c8f8877bbdc9' on account ********
20:50:16.714 [main] INFO  software.amazon.lambda.powertools.testutils.Infrastructure - Stack IdempotencyE2ET-c8f8877bbdc9 successfully deployed
20:50:33.978 [main] INFO  software.amazon.lambda.powertools.testutils.Infrastructure - Deleting 'IdempotencyE2ET-c8f8877bbdc9' on account ********
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 94.41 s -- in software.amazon.lambda.powertools.IdempotencyE2ET
[INFO] 
[INFO] Results:
[INFO] 
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0

Checklist

• Meet tenets criteria
• Update tests
• Update docs
• PR title follows conventional commit semantics

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[sonarqubecloud]

Quality Gate passed

Issues
7 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[dreamorosi]

Great work on the PR, I left two comments but you can resolve if you don't find them relevant.

Also TIL about transient - neat!

[dreamorosi]

@phipag feel free to merge any time. No rush - just letting you know I'm ok with the comments and have resolved all the threads.

[phipag]

Awesome! Thanks for your prompt review. Merging now.