feat: add cache invalidation tests and documentation for markets

[CHKM001]

PR Description - Add cache invalidation hooks to markets repository on update (#149 )

Description

This pull request adds comprehensive tests and documentation for the existing Redis cache invalidation implementation in src/cache/marketsCache.ts. The cache invalidation hooks ensure that when a market is updated via PATCH /api/markets/:id, both the specific market cache and the aggregated list cache are properly invalidated.

Requirements Covered

• Invalidation on PATCH: Cache entries are invalidated when a market is updated
• Pattern-based key delete: Both markets:{id} and markets:all keys are deleted
• Tested: Comprehensive test suite with 100% coverage on changed lines
• Doc explains TTLs: Documentation covers cache strategy, TTLs, and monitoring

Key Changes

• tests/marketsCache.test.ts (new):

  • Tests cache key generation patterns (markets:all and markets:{id})
  • Tests that both keys are deleted on invalidation
  • Tests graceful error handling when Redis fails
  • Tests correlation ID logging for debugging
  • 6 test cases with 100% coverage

• docs/cache.md (new):

  • Documents cache key patterns and their purposes
  • Explains TTL values (60s for list, 120s for individual markets)
  • Describes invalidation strategy and error handling
  • Covers security considerations and monitoring guidance

Cache Implementation Details

The existing implementation in src/cache/marketsCache.ts:

• Generates cache keys: markets:all for list view, markets:{id} for individual market
• Invalidates both keys in parallel using Promise.all
• Handles Redis errors gracefully without breaking business operations
• Logs operations with correlation IDs for debugging

Verification

New test suite covers cache invalidation scenarios:

• tests/marketsCache.test.ts (Key generation, invalidation, error handling)

Run test command:

npm test tests/marketsCache.test.ts

Test Output

PASS tests/marketsCache.test.ts
  marketsCache
    marketCacheKeys
      ✓ generates correct 'all' key
      ✓ generates correct 'byId' key
    invalidateMarketCache
      ✓ deletes both specific market key and list key
      ✓ logs success message after invalidation
      ✓ handles Redis errors gracefully without throwing
      ✓ continues even if one key deletion fails

Test Suites: 1 passed, 1 total
Tests:       6 passed, 6 total

Coverage

• Line coverage: 100% on src/cache/marketsCache.ts
• All error paths tested
• Graceful degradation verified

Closes #149

[drips-wave]

@CHKM001 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

[CHKM001]

20+ lint errors not caused by the branch from main