redis

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

type Credentials struct {
	Username string
	Password string
}

type CredentialsProvider func(ctx context.Context) (Credentials, error)

type Options struct {
	// Addr is the host:port of the server. Default "127.0.0.1:6379".
	Addr string

	// Credentials is the primary auth path. If non-nil it overrides
	// Username / Password and is called once per new connection,
	// receiving the caller's context. Use it for short-lived tokens
	// (IAM / OIDC / Vault leases) that need refresh.
	Credentials CredentialsProvider

	// Password is the static-credentials shorthand. Used only when
	// Credentials is nil. Empty means no AUTH.
	Password string

	// Username pairs with Password as the static-credentials
	// shorthand (Redis 6+ ACL). Used only when Credentials is nil.
	// Empty falls back to the legacy single-arg AUTH form.
	Username string

	// TLS, if non-nil, enables TLS for new connections. Ignored when
	// Dialer is set (the custom Dialer is responsible for its own
	// transport encryption).
	TLS *tls.Config

	// DB is the database index to SELECT on connect (0..15 typically).
	DB int

	// ClientName is sent via CLIENT SETNAME on connect so the
	// connection shows up identifiable in CLIENT LIST / SLOWLOG /
	// MONITOR. Default "drops".
	ClientName string

	// MaxConns caps the simultaneous connections. Default 10.
	MaxConns int

	// MinIdleConns pre-dials this many connections at startup (and
	// keeps them warm best-effort). Smooths cold-start latency.
	// Default 0 (lazy). Must be ≤ MaxConns.
	MinIdleConns int

	// IdleTimeout closes connections that have been idle this long
	// before they're reused. 0 disables. Default 5 minutes.
	IdleTimeout time.Duration

	// MaxLifetime caps the absolute age of a connection regardless of
	// idle status. Important when AUTH tokens rotate or a load
	// balancer wants to drain connections. 0 disables. Default 0.
	MaxLifetime time.Duration

	// DialTimeout caps a single TCP+TLS+AUTH+SELECT+SETNAME dance.
	// Default 5s.
	DialTimeout time.Duration

	// ReadTimeout / WriteTimeout cap per-command I/O when the
	// caller's context has no deadline. Without these a misbehaving
	// server could hang the goroutine indefinitely. Default 3s each.
	// Set to a negative value to disable.
	ReadTimeout  time.Duration
	WriteTimeout time.Duration

	// MaxRetries is the number of retry attempts on a transient
	// transport error (broken pipe, EOF, network timeout, protocol
	// error). App-level errors (-ERR replies) are never retried.
	// Default 1.
	MaxRetries int

	// ShutdownTimeout caps how long Close waits for in-flight
	// operations to drain before forcing socket closure. Default 5s.
	ShutdownTimeout time.Duration

	// Dialer overrides the net.Dialer used for new connections. When
	// set, the TLS option is ignored.
	Dialer func(ctx context.Context, network, addr string) (net.Conn, error)

	// Hook fires after every operation. Compose with drops.LoggerHook
	// for instant request logging.
	Hook drops.Hook

	// KeyPrefix is prepended to every key. Useful for multi-tenant
	// deployments sharing a Redis instance.
	KeyPrefix string
}

type PoolStats struct {
	// TotalConns is the number of open connections (idle + checked
	// out) at the moment of the snapshot.
	TotalConns int

	// Hits is the count of Get-from-pool calls that found a warm
	// connection ready to reuse.
	Hits int64

	// Misses is the count of Get-from-pool calls that had to dial a
	// new connection (or replaced a stale one).
	Misses int64

	// Timeouts is the count of Get-from-pool calls that returned
	// ctx.Err() while waiting for a slot.
	Timeouts int64

	// StaleClosed is the count of connections closed because they
	// exceeded IdleTimeout or MaxLifetime.
	StaleClosed int64

	// WaitCount is the count of Get-from-pool calls that had to
	// wait > 0 for a slot (i.e. the pool was at capacity).
	WaitCount int64

	// WaitDuration is the total time spent waiting for pool slots.
	WaitDuration time.Duration

	// Retries is the count of transient errors that triggered a
	// retry attempt.
	Retries int64
}