cache

type Cache interface {
	// Connect establishes a connection to the cache backend
	Connect(ctx context.Context) error

	// Disconnect closes the connection to the cache backend
	Disconnect(ctx context.Context) error

	// Ping checks if the cache backend is accessible
	Ping(ctx context.Context) error

	// Get retrieves a value from the cache by key
	// Returns ErrNotFound if the key doesn't exist
	Get(ctx context.Context, key string) ([]byte, error)

	// Set stores a value in the cache with the given key and TTL
	// If ttl is 0, uses the default TTL from config
	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 in the cache
	Exists(ctx context.Context, key string) (bool, error)

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

	// Keys returns all keys matching the pattern
	// Pattern uses glob-style matching (* for wildcard)
	Keys(ctx context.Context, pattern string) ([]string, error)

	// TTL returns the remaining time-to-live for a key
	// Returns 0 if the key has no expiration
	TTL(ctx context.Context, key string) (time.Duration, error)

	// Expire sets a new TTL for a key
	Expire(ctx context.Context, key string, ttl time.Duration) error
}

type Config struct {
	// Driver specifies the cache backend: "inmemory", "redis", "memcached"
	Driver string

	// URL is the connection string for the cache backend
	// Examples:
	//   - Redis: "redis://localhost:6379/0"
	//   - Memcached: "memcached://localhost:11211"
	//   - In-Memory: "" (not used)
	URL string

	// DefaultTTL is the default time-to-live for cache entries
	// Used when Set() is called with ttl=0
	DefaultTTL time.Duration

	// MaxSize is the maximum number of items in the cache (in-memory only)
	// 0 means unlimited
	MaxSize int

	// CleanupInterval is how often to clean up expired items (in-memory only)
	CleanupInterval time.Duration

	// MaxKeySize is the maximum allowed key size in bytes
	MaxKeySize int

	// MaxValueSize is the maximum allowed value size in bytes
	MaxValueSize int

	// Prefix is prepended to all keys
	// Useful for namespacing in shared cache instances
	Prefix string

	// ConnectionPoolSize is the number of connections to maintain (Redis/Memcached)
	ConnectionPoolSize int

	// ConnectionTimeout is the timeout for establishing a connection
	ConnectionTimeout time.Duration

	// ReadTimeout is the timeout for read operations
	ReadTimeout time.Duration

	// WriteTimeout is the timeout for write operations
	WriteTimeout time.Duration

	// RequireConfig determines if config must exist in ConfigManager
	// If true, extension fails to start without config
	// If false, uses defaults when config is missing
	RequireConfig bool
}

type ConfigOption func(*Config)

type CounterCache interface {
	Incr(ctx context.Context, key string) (int64, error)
	IncrBy(ctx context.Context, key string, value int64) (int64, error)
	Decr(ctx context.Context, key string) (int64, error)
	DecrBy(ctx context.Context, key string, value int64) (int64, error)
}

type Extension struct {
	*forge.BaseExtension
	// contains filtered or unexported fields
}

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

type JSONCache interface {
	GetJSON(ctx context.Context, key string, target any) error
	SetJSON(ctx context.Context, key string, value any, ttl time.Duration) error
}

type MultiCache interface {
	MGet(ctx context.Context, keys ...string) ([][]byte, error)
	MSet(ctx context.Context, kvs map[string][]byte, ttl time.Duration) error
	MDelete(ctx context.Context, keys ...string) error
}

type StringCache interface {
	GetString(ctx context.Context, key string) (string, error)
	SetString(ctx context.Context, key string, value string, ttl time.Duration) error
}