cache

type Cache interface {
	// Get retrieves a value from the cache
	Get(key string) (interface{}, bool)

	// Set adds a value to the cache with the given TTL
	Set(key string, value interface{}, ttl time.Duration)

	// Delete removes a value from the cache
	Delete(key string)

	// Clear removes all items from the cache
	Clear()

	// Prefetch queues a key for background prefetching
	Prefetch(key string)

	// Close closes the cache
	Close() error

	// GetMetrics returns cache metrics
	GetMetrics() *Metrics
}

type CacheType string

type InvalidationAction string

type InvalidationCondition string

type InvalidationPattern struct {
	// Pattern is the pattern to match cache keys
	Pattern string

	// Action is the action to take when the pattern matches
	Action InvalidationAction

	// Condition is the condition for invalidation
	Condition InvalidationCondition
}

type Manager struct {
	// Cache is the underlying cache implementation
	Cache Cache

	// Options are the cache manager options
	Options *ManagerOptions
	// contains filtered or unexported fields
}

type ManagerOptions struct {
	// PrefetchConcurrency is the number of concurrent prefetch operations
	PrefetchConcurrency int

	// PrefetchQueueSize is the size of the prefetch queue
	PrefetchQueueSize int

	// EnablePrefetching enables background prefetching
	EnablePrefetching bool

	// EnableInvalidation enables cache invalidation
	EnableInvalidation bool

	// DefaultTTL is the default time-to-live for cached items
	DefaultTTL time.Duration

	// RefreshBeforeExpiry is the duration before expiry to refresh items
	RefreshBeforeExpiry time.Duration

	// RefreshCallback is called to refresh a cached item
	RefreshCallback func(ctx context.Context, key string) (interface{}, error)
}

type Metrics struct {
	// Gets is the number of Get operations
	Gets int64

	// Sets is the number of Set operations
	Sets int64

	// Hits is the number of cache hits
	Hits int64

	// Misses is the number of cache misses
	Misses int64

	// Deletes is the number of Delete operations
	Deletes int64

	// Clears is the number of Clear operations
	Clears int64

	// Errors is the number of errors
	Errors int64

	// Prefetches is the number of prefetch requests
	Prefetches int64

	// PrefetchesProcessed is the number of processed prefetch requests
	PrefetchesProcessed int64

	// Size is the current size of the cache in bytes
	Size int64
	// contains filtered or unexported fields
}

type Options struct {
	// CacheDir is the directory to store cached data
	CacheDir string

	// DefaultTTL is the default time-to-live for cached items
	DefaultTTL time.Duration

	// MaxSize is the maximum size of the cache in bytes (0 = unlimited)
	MaxSize int64

	// MemoryLimit is the maximum memory usage in bytes (0 = unlimited)
	MemoryLimit int64

	// ReadOnly opens the cache in read-only mode
	ReadOnly bool

	// EnablePrefetching enables background prefetching
	EnablePrefetching bool

	// PrefetchConcurrency is the number of concurrent prefetch operations
	PrefetchConcurrency int

	// EnableCompression enables compression for cached values
	EnableCompression bool

	// EnableEncryption enables encryption for cached values
	EnableEncryption bool

	// EncryptionKey is the key used for encryption
	EncryptionKey []byte

	// EnableMetrics enables collection of cache metrics
	EnableMetrics bool
}

type PrefetchRequest struct {
	// Key is the cache key
	Key string

	// Priority is the priority of the request (higher = more important)
	Priority int

	// Callback is called to fetch the item if not in cache
	Callback func(ctx context.Context) (interface{}, error)
}