feat(idempotency): add idempotency decorator

[am29d]

Description of your changes

This PR adds @idempotent decorator to the utility. We initially implemented it, but removed later due to uncertainty about decorator interface with TypeScript 5.x upgrade. Now we can restore and simplify the old implementation, by internally calling makeIdempotent, making it syntactic sugar for this functionality. This also means that most of e2e tests are very similar to the makeIdempotent tests, but we still need to make sure that it works when wrapping around decorator.

Related issues, RFCs

Issue number: closes #1700

Checklist

• My changes meet the tenets criteria
• I have performed a self-review of my own code
• I have commented my code where necessary, particularly in areas that should be flagged with a TODO, or hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my change is effective and works
• The PR title follows the conventional commit semantics

Breaking change checklist

Is it a breaking change?: NO

• I have documented the migration process
• I have added, implemented necessary warnings (if it can live side by side)

---

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

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

[sonarqubecloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

No Coverage information
22.2% Duplication

[github-actions]

No related issues found. Please ensure there is an open issue related to this change to avoid significant delays or closure.

[am29d]

✅ e2e tests

[dreamorosi]

Great work on this PR, Alex!

I've left a few comments on the docs only. The general feedback would be to: 1/ let's try to start using import type { fooBar } from '...'; when importing types. This helps with telling TS what we are importing.

[dreamorosi]

Thanks for running the integration tests, they are passing 🎉