feat: Add Idempotency Package

[hossambarakat]

Issue number: #164

Summary

Changes

Introduce Idempotency package to convert Lambda functions into idempotent operations which are safe to retry.

User experience

This is a new package, Here is a summary of how to use the package

1- Install the package

dotnet add package AWS.Lambda.Powertools.Idempotency

2- Prepare DynamoDB table to store request and response details
3- Configure the Idempotency package using Idempotency.Configure
4- Add the Idempotent attribute on top of the function

public class Function
{
    public Function()
    {
        Idempotency.Configure(builder => builder.UseDynamoDb("idempotency_table"));
    }
    
    [Idempotent]
    public Task<string> FunctionHandler(string input, ILambdaContext context)
    {
        return Task.FromResult(input.ToUpper());
    }
}

Checklist

Please leave checklist items unchecked if they do not apply to your change.

• Meets tenets criteria
• I have performed a self-review of this change
• Changes have been tested
• Changes are documented
• PR title follows conventional commit semantics

Is this a breaking change?

No

RFC issue number:

Checklist:

• Migration process documented
• Implement warnings (if it can live side by side)

Acknowledgment

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

---

View rendered docs/core/idempotency.md
View rendered libraries/src/AWS.Lambda.Powertools.Idempotency/README.md

[codecov-commenter]

Codecov Report

Patch coverage: 80.76% and project coverage change: +6.40 🎉

Comparison is base (569ed17) 62.54% compared to head (33de0e1) 68.94%.

Additional details and impacted files

@@             Coverage Diff             @@
##           develop     #163      +/-   ##
===========================================
+ Coverage    62.54%   68.94%   +6.40%     
===========================================
  Files           61       79      +18     
  Lines         2627     3433     +806     
===========================================
+ Hits          1643     2367     +724     
- Misses         984     1066      +82     

Flag	Coverage Δ
unittests	68.94% <80.76%> (+6.40%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
....Powertools.Common/Core/PowertoolsLambdaContext.cs	98.33% <ø> (ø)
...cy/Exceptions/IdempotencyConfigurationException.cs	0.00% <0.00%> (ø)
...xceptions/IdempotencyInconsistentStateException.cs	0.00% <0.00%> (ø)
...Exceptions/IdempotencyPersistenceLayerException.cs	0.00% <0.00%> (ø)
...xceptions/IdempotencyAlreadyInProgressException.cs	33.33% <33.33%> (ø)
...ncy/Exceptions/IdempotencyItemNotFoundException.cs	33.33% <33.33%> (ø)
....Idempotency/Exceptions/IdempotencyKeyException.cs	33.33% <33.33%> (ø)
...tency/Exceptions/IdempotencyValidationException.cs	33.33% <33.33%> (ø)
...s.Idempotency/Internal/IdempotencyAspectHandler.cs	52.83% <52.83%> (ø)
...xceptions/IdempotencyItemAlreadyExistsException.cs	66.66% <66.66%> (ø)
... and 10 more

... and 3 files with indirect coverage changes

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

[amirkaws]

LGTM, Thanks for your contribution.