cache

type Cache interface {
	// Get retrieves a value from the cache.
	// Returns the value and a boolean indicating if it was found.
	Get(ctx context.Context, key string) ([]byte, bool, error)

	// Set stores a value in the cache with a TTL.
	// A zero TTL means the item never expires.
	Set(ctx context.Context, key string, value []byte, ttl time.Duration) error

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

	// Exists checks if a key exists in the cache.
	Exists(ctx context.Context, key string) (bool, error)

	// GetMulti retrieves multiple values from the cache.
	// Returns a map of key to value for found items.
	GetMulti(ctx context.Context, keys []string) (map[string][]byte, error)

	// SetMulti stores multiple values in the cache with a TTL.
	SetMulti(ctx context.Context, items map[string][]byte, ttl time.Duration) error

	// Invalidate removes all items matching the pattern.
	// Pattern supports wildcards: * matches any sequence of characters.
	Invalidate(ctx context.Context, pattern string) error

	// Stats returns cache statistics.
	Stats() Stats

	// Warm pre-loads the cache with frequently accessed data.
	Warm(ctx context.Context, keys []string) error

	// Close gracefully shuts down the cache.
	Close() error
}

type Config struct {
	// MaxSize is the maximum number of items in the in-memory cache
	MaxSize int64 `env:"MAX_SIZE,default=10000"`
	// MaxSizeInMB is the maximum memory usage in MB for the in-memory cache
	MaxSizeInMB int64 `env:"MAX_SIZE_MB,default=256"`
	// DefaultTTL is the default TTL for cached items
	DefaultTTL time.Duration `env:"DEFAULT_TTL,default=1h"`
	// EnableMetrics enables detailed metrics collection
	EnableMetrics bool `env:"ENABLE_METRICS,default=true"`
	// WarmupKeys is a list of keys to pre-load on startup
	WarmupKeys []string `env:"WARMUP_KEYS"`
}

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

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

type HybridCacheConfig struct {
	LocalSizeMB      int64
	LocalTTL         time.Duration
	Prefix           string
	InvalidatePrefix string
}

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

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

type ManagerConfig struct {
	// LLM Responses configuration
	Responses struct {
		Strategy      string        `env:"STRATEGY,default=auto"`
		TTL           time.Duration `env:"TTL,default=1h"`
		MaxItemSizeKB int           `env:"MAX_ITEM_SIZE_KB,default=1024"`
		LocalSizeMB   int64         `env:"LOCAL_SIZE_MB,default=256"`
	} `env:",prefix=RESPONSES_"`

	// Model Metadata configuration
	Models struct {
		Strategy string        `env:"STRATEGY,default=local"`
		TTL      time.Duration `env:"TTL,default=6h"`
		SizeMB   int64         `env:"SIZE_MB,default=16"`
	} `env:",prefix=MODELS_"`
}

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

type NoopPubSub struct{}

type Policy struct {
	// TTL is the time-to-live for this type of data
	TTL time.Duration
	// MaxSize is the maximum size in bytes for cacheable items
	MaxSize int64
	// Compress indicates whether to compress the data
	Compress bool
	// SkipCache indicates whether to skip caching entirely
	SkipCache bool
}

type PolicyType string

type PubSubClient = storage.PubSubClient

type PubSubProvider = storage.PubSubProvider

type Stats struct {
	// Hits is the number of cache hits
	Hits uint64 `json:"hits"`
	// Misses is the number of cache misses
	Misses uint64 `json:"misses"`
	// Sets is the number of items added to cache
	Sets uint64 `json:"sets"`
	// Deletes is the number of items deleted from cache
	Deletes uint64 `json:"deletes"`
	// Evictions is the number of items evicted due to size/TTL
	Evictions uint64 `json:"evictions"`
	// HitRate is the cache hit rate (hits / (hits + misses))
	HitRate float64 `json:"hit_rate"`
	// Size is the current number of items in cache
	Size int64 `json:"size"`
	// SizeInBytes is the approximate memory usage
	SizeInBytes int64 `json:"size_in_bytes"`
}