cache

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

type CacheStats struct {
	Metadata    map[string]interface{} `json:"metadata"`
	L1Size      int64                  `json:"l1_size"`
	L2Size      int64                  `json:"l2_size"`
	L1HitRate   float64                `json:"l1_hit_rate"`
	L2HitRate   float64                `json:"l2_hit_rate"`
	SemanticHit int64                  `json:"semantic_hits"`
	TotalHits   int64                  `json:"total_hits"`
	TotalMisses int64                  `json:"total_misses"`
}

type Config struct {
	OnEviction      func(key string, value any)
	DefaultTTL      time.Duration
	CleanupInterval time.Duration
	MaxItems        int
}

type Interface interface {
	// Set adds a value to the cache with the default TTL.
	Set(ctx context.Context, key string, value any)

	// SetWithTTL adds a value to the cache with a custom TTL.
	SetWithTTL(ctx context.Context, key string, value any, ttl time.Duration)

	// Get retrieves a value from the cache.
	Get(ctx context.Context, key string) (any, bool)

	// Delete removes a value from the cache.
	Delete(ctx context.Context, key string)

	// Clear removes all values from the cache.
	Clear(ctx context.Context)

	// Size returns the number of items in the cache.
	Size() int64

	// Close stops all background tasks and releases resources.
	Close() error
}

type L3Fetcher func(ctx context.Context, key string) (any, error)

type NilRedisCache struct{}

type RedisCacheConfig struct {
	Addr         string
	Password     string
	KeyPrefix    string
	DB           int
	DefaultTTL   time.Duration
	PoolSize     int
	MinIdleConns int
}

type RedisCacheInterface interface {
	Set(ctx context.Context, key string, value any)
	SetWithTTL(ctx context.Context, key string, value any, ttl time.Duration)
	Get(ctx context.Context, key string) (any, bool)
	Delete(ctx context.Context, key string)
	Clear(ctx context.Context)
	Close() error
}

type RedisCacheStats struct {
	Keyspace string  `json:"keyspace"`
	KeyCount int64   `json:"key_count"`
	Memory   int64   `json:"memory_bytes"`
	HitRate  float64 `json:"hit_rate"`
}

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

type SemanticCacheEntry struct {
	Timestamp time.Time `json:"timestamp"`
	Results   any       `json:"results"`
	Query     string    `json:"query"`
	Embedding []float32 `json:"embedding"`
}

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

type TieredCacheConfig struct {
	L1MaxItems int           // Max items in L1 memory cache
	L1TTL      time.Duration // TTL for L1 cache entries
	L2TTL      time.Duration // TTL for L2 Redis cache entries
	EnableL1   bool          // Enable L1 memory cache (default: true)
	EnableL2   bool          // Enable L2 Redis cache (default: false, auto-enabled if DIVINESENSE_CACHE_REDIS_ADDR set)
}