cache

type Cache interface {
	// Get retrieves data from the cache
	// Returns (data, found, stale) where stale indicates data is stale but usable
	Get(key string) ([]map[string]interface{}, bool, bool)

	// Set stores data in the cache with the given TTL
	Set(key string, data []map[string]interface{}, ttl time.Duration)

	// SetWithStale stores data with separate stale and expire times
	// staleAfter: duration until data becomes stale
	// expireAfter: duration until data expires completely
	SetWithStale(key string, data []map[string]interface{}, staleAfter, expireAfter time.Duration)

	// Invalidate removes an entry from the cache
	Invalidate(key string)

	// InvalidateAll removes all entries from the cache
	InvalidateAll()
}

type CacheInfo struct {
	Cached     bool   `json:"cached"`     // Whether data came from cache
	Age        string `json:"age"`        // How old the cached data is (e.g., "2m30s")
	ExpiresIn  string `json:"expires_in"` // Time until expiry (e.g., "4m15s")
	Stale      bool   `json:"stale"`      // Whether data is stale (but still usable)
	Refreshing bool   `json:"refreshing"` // Whether background refresh is in progress
}

type Entry struct {
	Data      []map[string]interface{}
	ExpiresAt time.Time
	StaleAt   time.Time // For stale-while-revalidate: when data becomes stale (but still usable)
}

type MemoryCache struct {
	// contains filtered or unexported fields
}