embedded

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

type Config struct {
	// DiskPath is the path to the cache data directory (required)
	DiskPath string

	// TTL is the default time-to-live for cache entries (required)
	TTL time.Duration

	// MaxDiskUsage is the maximum disk usage in bytes (0 = unlimited)
	MaxDiskUsage int64

	// InlineThreshold is the size threshold for inline vs file storage (default: 64KB)
	// Objects smaller than this are stored in RocksDB, larger ones as files.
	InlineThreshold int

	// NodeID is the unique identifier for this node in cluster mode
	NodeID string

	// ClusterAddr is the address for cluster membership (gossip) protocol
	// Example: ":7000"
	ClusterAddr string

	// GRPCAddr is the address for the gRPC server to listen on
	// Example: ":9000"
	GRPCAddr string

	// AdvertiseAddr is the address advertised to other nodes for gRPC connections
	// Example: "node1.cluster:9000"
	AdvertiseAddr string

	// SeedNodes is a list of seed nodes for cluster discovery
	// Example: []string{"node1:7000", "node2:7000"}
	SeedNodes []string

	// RequestLogging enables logging of gRPC requests (default: false)
	RequestLogging bool

	// GRPCServerOptions are additional gRPC server options (e.g., auth interceptors).
	// These are appended after the default options (message size limits, epoch interceptors).
	GRPCServerOptions []grpc.ServerOption

	// GRPCDialOptions are additional gRPC dial options for inter-node connections (e.g., auth interceptors).
	// These are appended after the default options (transport credentials, keepalive, message size).
	GRPCDialOptions []grpc.DialOption

	// Storage provides advanced tuning for the local storage layer (compaction,
	// segment sizing, RocksDB block cache, fd cache, TTL cleanup interval, etc.).
	// When set, its fields are applied as the base; the top-level DiskPath, TTL,
	// MaxDiskUsage, and InlineThreshold fields above take precedence when non-zero.
	// Unset fields fall through to storage-layer defaults.
	Storage *stor.StorageConfig

	// Lifecycler provides advanced cluster ring tuning (heartbeat period/timeout,
	// replication factor, num tokens, observe period, tokens file path, etc.).
	// Ignored when cluster mode is not enabled.
	Lifecycler *ring.LifecyclerConfig

	// Router provides advanced inter-node routing tuning (connection timeout,
	// retry/backoff, keepalive, circuit breaker, message sizes).
	// When nil, coordinator defaults are used.
	// Ignored when cluster mode is not enabled.
	Router *coordinator.RouterConfig

	// Registerer is the Prometheus registerer used for cluster metrics.
	// When nil, prometheus.DefaultRegisterer is used. Provide a dedicated
	// registerer to avoid duplicate-registration panics when embedding
	// multiple instances or integrating with a custom metrics registry.
	Registerer prometheus.Registerer
}