feat: Add repositories for the redesigned hbar limiter

[victor-yanev]

Description:

This PR introduces repositories for managing spending plans for HBAR rate limiting and managing links between ETH addresses and a spending plan (IP address limiting could also be added the same way by adding IpAddressPlan and IpAddressPlanRepository).

Changes

Repositories:

• HbarLimitPlanRepository: Provides methods to create, retrieve, and manage HBAR limit plans, including:
  • findById
  • findByIdWithDetails
  • create
  • checkExistsAndActive
  • getSpendingHistory
  • addAmountToSpendingHistory
  • getSpentToday
  • addAmountToSpentToday
• EthAddressPlanRepository: Provides methods to manage Ethereum address plans, including:
  • findByAddress
  • save
  • delete

Testing

• Added unit tests for HbarLimitPlanRepository and EthAddressPlanRepository to ensure proper functionality.
• Tests cover scenarios such as creating plans, retrieving plans by ID, managing spending history, and handling non-existent plans.

Related issue(s):

Fixes #2869

Notes

• The new repositories are designed to work with the existing cache service for data storage and retrieval.
• Logging has been integrated into the repositories to provide traceability for operations performed.

Checklist

• Documented (Code comments, README, etc.)
• Tested (unit, integration, etc.)

[github-actions]

Acceptance Tests

  19 files  249 suites   29m 1s ⏱️
611 tests 590 ✔️ 4 💤 17 ❌
834 runs  813 ✔️ 4 💤 17 ❌

Results for commit 01b6c2e.

♻️ This comment has been updated with latest results.

[github-actions]

Tests

       3 files     246 suites   18s ⏱️
1 114 tests 1 113 ✔️ 1 💤 0 ❌
1 126 runs  1 125 ✔️ 1 💤 0 ❌

Results for commit 01b6c2e.

♻️ This comment has been updated with latest results.

[codecov]

Codecov Report

Attention: Patch coverage is 95.48872% with 6 lines in your changes missing coverage. Please review.

Project coverage is 83.43%. Comparing base (b2a240b) to head (79e7be8).

Files	Patch %	Lines
...elay/src/lib/services/cacheService/cacheService.ts	84.21%	2 Missing and 4 partials ⚠️

Additional details and impacted files

@@                       Coverage Diff                        @@
##           2866-add-hbar-limit-entities    #2870      +/-   ##
================================================================
+ Coverage                         82.70%   83.43%   +0.73%     
================================================================
  Files                                47       38       -9     
  Lines                              3457     2922     -535     
  Branches                            731      615     -116     
================================================================
- Hits                               2859     2438     -421     
+ Misses                              371      289      -82     
+ Partials                            227      195      -32     

Flag	Coverage Δ
relay	83.43% <95.48%> (+0.65%)	⬆️
server	?
ws-server	?

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

Files	Coverage Δ
...kages/relay/src/lib/clients/cache/localLRUCache.ts	80.55% <100.00%> (+1.76%)	⬆️
packages/relay/src/lib/clients/cache/redisCache.ts	92.10% <100.00%> (+1.62%)	⬆️
...positories/hbarLimiter/EthAddressPlanRepository.ts	100.00% <100.00%> (ø)
...epositories/hbarLimiter/HbarLimitPlanRepository.ts	100.00% <100.00%> (ø)
...kages/relay/src/lib/db/types/hbarLimiter/errors.ts	100.00% <100.00%> (ø)
...elay/src/lib/services/cacheService/cacheService.ts	92.72% <84.21%> (-3.11%)	⬇️

... and 20 files with indirect coverage changes

[sonarqubecloud]

Quality Gate passed

Issues
3 New issues
0 Accepted issues

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

See analysis details on SonarCloud