- Add CacheMetaStore (AsyncLocalStorage) in shared/infrastructure so
cache metadata can propagate across async call stacks per-request
- Extend CacheService.getOrSet to store { __v, cachedAt, ttlSeconds }
envelopes in Redis; reads back envelope to compute nextRefreshAt.
Legacy plain-JSON entries are served transparently (cachedAt: null)
- Add CacheMetaInterceptor that wraps every analytics response as
{ data: T, cacheMeta: { cachedAt, nextRefreshAt, source } } using
the per-request ALS store populated by CacheService
- Apply @UseInterceptors(CacheMetaInterceptor) on both
AnalyticsController and AvmController (class-level)
- Update cache.service.spec.ts to expect envelope format on write
- Add cache-meta.interceptor.spec.ts with 6 tests covering market-report,
price-trend, heatmap endpoints, cache-hit path, and ALS isolation
- Add analytics module README documenting the pattern for future devs
Co-Authored-By: Paperclip <noreply@paperclip.ing>
a70db64da1