cache

type Cache interface {
	// Get retrieves a value by key.
	// Returns ErrNotFound if the key doesn't exist or has expired.
	Get(ctx context.Context, key string) ([]byte, error)

	// Set stores a value with the given TTL.
	// If ttl is 0, the value never expires.
	Set(ctx context.Context, key string, value []byte, ttl time.Duration) error

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

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

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

	// Close releases any resources held by the cache.
	Close() error
}

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

type MemoryConfig struct {
	// CleanupInterval is how often to remove expired items.
	// Default: 1 minute. Set to 0 to disable background cleanup.
	CleanupInterval time.Duration

	// InitialCapacity is the initial map capacity.
	// Default: 100.
	InitialCapacity int
}

type MiddlewareConfig struct {
	// TTL is how long to cache responses. Default: 5 minutes.
	TTL time.Duration

	// KeyFunc generates cache keys from requests.
	// Default: method + path + sorted query string.
	KeyFunc func(r *http.Request) string

	// KeyPrefix is prepended to all cache keys.
	KeyPrefix string

	// Skip returns true to skip caching for a request.
	Skip func(r *http.Request) bool

	// CacheErrors caches non-2xx responses. Default: false.
	CacheErrors bool
}

type MultiDeleter interface {
	DeleteMulti(ctx context.Context, keys []string) error
}

type MultiGetter interface {
	GetMulti(ctx context.Context, keys []string) (map[string][]byte, error)
}

type MultiSetter interface {
	SetMulti(ctx context.Context, items map[string][]byte, ttl time.Duration) error
}

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

type RedisConfig struct {
	// Client is an existing Redis client.
	// If provided, other connection options are ignored.
	Client redis.UniversalClient

	// Address is the Redis server address (e.g., "localhost:6379").
	Address string

	// Password for Redis authentication.
	Password string

	// DB is the database number to use.
	DB int

	// KeyPrefix is prepended to all keys.
	KeyPrefix string

	// PoolSize is the maximum number of connections.
	// Default: 10.
	PoolSize int

	// DialTimeout is the timeout for establishing connections.
	// Default: 5 seconds.
	DialTimeout time.Duration

	// ReadTimeout is the timeout for read operations.
	// Default: 3 seconds.
	ReadTimeout time.Duration

	// WriteTimeout is the timeout for write operations.
	// Default: 3 seconds.
	WriteTimeout time.Duration
}