cache-manager - feat: add store layer identification to event payloads

[faizanu94]

Please check if the PR fulfills these requirements

• Followed the Contributing guidelines.
• Tests for the changes have been added (for bug fixes/features) with 100% code coverage.
• Docs have been added / updated (for bug fixes / features)

What kind of change does this PR introduce? (Bug fix, feature, docs update, ...)
Implements #1128 by adding store layer identification to event payloads in cache-manager.

Previously, event payloads (get, set, etc.) did not include which store/layer (primary or secondary) was responsible. This limited monitoring and debugging when multiple stores were configured.

Changes

• Added _storeLabel helper:
  • "primary" for index 0
  • "secondary:N" for deeper layers
• Updated get and set (including errors) to emit the store field in event payloads.
• Added unit tests:
  • events.test.ts – verifies get payload includes store and value, error events include store.
  • multiple-stores.test.ts – verifies secondary hit emits correct store, per-layer set emits store IDs, and deeper layers (e.g., "secondary:1") are labeled correctly.

Motivation

This enables:

• Monitoring hit/miss rates per cache layer
• Debugging which layer served a value
• Collecting metrics for performance and cost optimization

Result

Event payloads are now enriched with store information while maintaining backward compatibility.

[jaredwray]

@faizanu94 - thanks for submitting this PR. I will look at this later today or tomorrow once npm starts working better as they are having issues right now.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (1868881) to head (44c6e14).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##              main     #1270   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           35        35           
  Lines         4186      4190    +4     
  Branches      1180      1179    -1     
=========================================
+ Hits          4186      4190    +4     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[jaredwray]

@faizanu94 - thanks for doing this. I will keep the issue open as I will want to add it to cacheable also.

[jaredwray]

This should be live pretty soon.

[faizanu94]

Thanks @jaredwray 👍

Just saw cache:hit and cache:miss land in cacheable - that already brings in the store labels.

[jaredwray]

Thanks @jaredwray 👍

Just saw cache:hit and cache:miss land in cacheable - that already brings in the store labels.

Yep. able to get that added today!