feat(logger): add circular buffer

[VatsalGoel3]

Summary

This PR adds a new log buffering module for the logger package.

Changes

• Implemented a log buffering module with the following components:
  • SizedItem: Encapsulates a log entry and calculates its byte size using JSON serialization.
  • SizedSet: Extends Set to track the cumulative size of log entries and provides a FIFO removal method via shift().
  • CircularMap: Maps request identifiers to SizedSet buffers, enforces a maximum buffer size (in bytes), and evicts the oldest entries when necessary. Includes an optional onBufferOverflow callback.
• Added unit tests (packages/logger/tests/unit/logBuffer.test.ts) to validate the log buffering module.

Issue number: closes #3589

---

By submitting this pull request, I confirm that I have read and followed the Powertools for AWS Lambda (TypeScript) contributing guidelines, and I confirm that you can use, modify, copy, and redistribute this contribution under the terms of your choice.

[dreamorosi]

Hi @VatsalGoel3, thank you for the PR.

Could you please restore the PR template instead of rewriting it from scratch?

[dreamorosi]

Hi @VatsalGoel3, great PR so far!

Left a few notes that I'd like us to address before moving forward, let me know if you have any questions.

[VatsalGoel3]

@dreamorosi

I've incorporated the requested changes and made a few refinements:

Refactored the test for buffer overflow eviction

Removed JSON.stringify() in SizedItem

1. Now enforcing string values at runtime using isString()

2. Switched to to reflect the intended usage better.
   Let me know if we should revisit this for potential flexibility down the road!

   Updated test cases

   1. Added type adjustments in SizedSet and CircularMap to align with enforcing string values.

   2. Reworked the eviction test case to ensure correct behavior.

   Updated the code for Quality Gate failed.

[sonarqubecloud]

Quality Gate passed

Issues
0 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]

Thank you for the PR and for addressing my comments!

I'm going to be creating several more issues that open for contributions in the next day or so, if you're interested keep an eye out.