humanspeak / memory-cache / 21499828999

99%

main: 99%

push

github

feat: add getOrSet with single-flight, lifecycle hooks, and improved docs (#36)

* feat: add lifecycle hooks system for cache observability

Add opt-in hooks for observing cache lifecycle events:
- onHit: called on successful cache retrieval
- onMiss: called on cache miss (not_found or expired)
- onSet: called when value is stored (new or update)
- onEvict: called when entry is evicted due to size limit
- onExpire: called when entry expires due to TTL
- onDelete: called when entry is explicitly deleted

Hooks are synchronous and errors are silently caught to prevent
cache corruption. Each hook receives a typed context object with
relevant information about the event.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs: restructure examples into individual pages with hooks coverage

Split examples page into 9 separate focused pages:
- api-caching: API response caching patterns
- sessions: Session storage with audit logging
- configuration: Configuration cache with change detection
- database-caching: Database query caching with @cached decorator
- computed-values: Computed value caching with performance tracking
- multi-tenant: Multi-tenant cache invalidation patterns
- monitoring: Extensive hooks integration (DataDog, Prometheus, debug)
- rate-limiting: Rate limiting with monitoring
- service-class: Full service class pattern

Each example now includes a "With Hooks" variant showing monitoring
integration. Main examples page is now an overview with categorized
links and quick reference table.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs(examples): clarify checkRateLimit reference in rate-limiting example

Add comment noting that checkRateLimit function is defined in the
Basic Pattern section above to avoid reader confusion.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix(docs): prevent overview staying highlighted when viewing sub-pages

The sidebar isActive function was matching /docs/examples as a pre... (continued)

73 of 75 branches covered (97.33%)

Branch coverage included in aggregate %.

58 of 58 new or added lines in 1 file covered. (100.0%)

167 of 167 relevant lines covered (100.0%)

773.41 hits per line