Interface ResponseCacheProvider

core/cache.go:13–25

ResponseCacheProvider defines the interface for response caching. This is implemented by the service layer (serv package) to provide Redis-based caching with row-level invalidation.

// This is implemented by the service layer (serv package) to provide
// Redis-based caching with row-level invalidation.
type ResponseCacheProvider interface {
	// Get retrieves a cached response by key.
	// Returns (data, isStale, found). isStale is true if the entry is past soft TTL (SWR).
	Get(ctx context.Context, key string) (data []byte, isStale bool, found bool)

	// Set stores a response with dependency refs for invalidation.
	// refs may represent DB rows/tables, filesystem keys/prefixes, or resolver outputs.
	// queryStartTime is used for race condition detection.
	Set(ctx context.Context, key string, data []byte, refs []RowRef, queryStartTime time.Time) error

	// InvalidateRows invalidates cache entries for dependency refs.
	InvalidateRows(ctx context.Context, refs []RowRef) error
}

// CacheEntryOptions lets callers narrow cache lifetime for one entry without
// changing provider-wide defaults.