redis

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

type Config struct {
	// Host is the Redis server hostname or IP address.
	Host string `config:"host" required:"true"`

	// Port is the Redis server port (default: 6379).
	Port int `config:"port" default:"6379"`

	// Mode selects the protocol the client speaks: ModeStandalone (the default,
	// and what the empty string means) or ModeCluster. Cluster is required for a
	// cluster-protocol endpoint such as Amazon ElastiCache Serverless, which
	// answers MOVED to a single-node client. Under cluster, Database must be 0 —
	// the cluster client has no database selection. Filled from
	// config.RedisConfig, which owns the cache.redis.mode key (env
	// CACHE_REDIS_MODE); deliberately carries no config: tag, because nothing
	// injects this struct and the tags on the fields around it are dead (#1729).
	Mode string

	// Username is the Redis ACL user to authenticate as, sent as
	// AUTH <username> <password>. Empty authenticates as the implicit "default"
	// user. Requires Password — Validate refuses a name with an empty password,
	// because the driver then sends no AUTH and the dial would run as the default
	// user. Required by deployments that gate access with ACLs, such as Amazon
	// ElastiCache RBAC. Filled from config.RedisConfig, which owns the
	// cache.redis.username key (env CACHE_REDIS_USERNAME); deliberately carries
	// no config: tag, because nothing injects this struct and the tags on the
	// fields around it are dead (#1729).
	Username string

	// Password for Redis authentication (optional).
	// Should be provided via environment variable: CACHE_REDIS_PASSWORD
	Password string `config:"password"`

	// Database number to use (default: 0).
	// Redis supports databases 0-15 by default.
	Database int `config:"database" default:"0"`

	// PoolSize is the maximum number of socket connections (default: 10).
	// Higher values allow more concurrent operations but consume more resources.
	PoolSize int `config:"pool_size" default:"10"`

	// DialTimeout is the timeout for establishing new connections (default: 5s).
	DialTimeout time.Duration `config:"dial_timeout" default:"5s"`

	// LoadTimeout bounds each cache leg of cache.LoadThrough (cache.loadtimeout).
	// Zero leaves the helper on its own fallback; a deployment-resolved config always
	// carries a positive value.
	LoadTimeout time.Duration `config:"load_timeout" default:"500ms"`

	// ReadTimeout is the timeout for socket reads (default: 3s).
	// -1 disables timeout.
	ReadTimeout time.Duration `config:"read_timeout" default:"3s"`

	// WriteTimeout is the timeout for socket writes (default: 3s).
	// -1 disables timeout.
	WriteTimeout time.Duration `config:"write_timeout" default:"3s"`

	// MaxRetries is the maximum number of retries before giving up (default: 3).
	// -1 disables retries.
	MaxRetries int `config:"max_retries" default:"3"`

	// MinRetryBackoff is the minimum backoff between retries (default: 8ms).
	MinRetryBackoff time.Duration `config:"min_retry_backoff" default:"8ms"`

	// MaxRetryBackoff is the maximum backoff between retries (default: 512ms).
	MaxRetryBackoff time.Duration `config:"max_retry_backoff" default:"512ms"`

	// TLS configures the client-side TLS of the connection. Zero value =
	// plaintext.
	TLS TLSConfig `config:"tls"`
}

type TLSConfig struct {
	// Enabled turns TLS on. False with any other field set is refused.
	Enabled bool `config:"enabled"`

	// CAFile and CAValue name the root bundle that verifies the server.
	CAFile  string `config:"cafile"`
	CAValue string `config:"cavalue"`

	// CertFile and CertValue name the client certificate; a cert requires a key.
	CertFile  string `config:"certfile"`
	CertValue string `config:"certvalue"`

	// KeyFile and KeyValue name the client key; a key requires a cert.
	KeyFile  string `config:"keyfile"`
	KeyValue string `config:"keyvalue"`

	// ServerName overrides the SNI/verification hostname; empty defaults to Host.
	ServerName string `config:"servername"`

	// MinVersion: "" or "1.2" (default floor) | "1.3".
	MinVersion string `config:"minversion"`
}