cache

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

type Cache[K comparable] interface {
	// Stats returns stats about the Cache namespace
	Stats(Type) Stats
	// Name returns the name of the cache
	Name() string

	// Set adds an entry to the Cache
	Set(ctx context.Context, key K, value []byte, expire time.Time, cacheType Type) error
	// Get reads an entry into a Sink
	Get(ctx context.Context, key K, dest Sink) error
	// Remove removes an entry from the Cache
	Remove(ctx context.Context, key K)
}

type Getter[K comparable] interface {
	// Get returns the value identified by key, populating dest.
	//
	// The returned data must be unversioned. That is, key must
	// uniquely describe the loaded data, without an implicit
	// current time, and without relying on cache expiration
	// mechanisms.
	Get(ctx context.Context, key K, dest Sink) error
}

type GetterFunc[K comparable] func(ctx context.Context, key K, dest Sink) error

type GobSink[T any] struct {
	ByteSink
	// contains filtered or unexported fields
}

type Setter[K comparable] interface {
	Set(ctx context.Context, key K, value []byte,
		expire time.Time, cacheType Type) error
}

type SetterFunc[K comparable] func(ctx context.Context, key K, value []byte,
	expire time.Time, cacheType Type) error

type Sink interface {
	// SetBytes sets the value to the contents of v.
	// The caller retains ownership of v.
	SetBytes(v []byte, e time.Time) error

	// Bytes returns the value encoded as a slice
	// of bytes
	Bytes() []byte

	// Len tells the length of the internally encoded
	// representation of the value
	Len() int

	// Expire returns the time whe this entry will
	// be evicted from the Cache
	Expire() time.Time

	// Reset empties the content of the Sink
	Reset()
}

type SinkFn[T any] struct {
	ByteSink
	// contains filtered or unexported fields
}

type SinkType[T any] struct {
	Decode func([]byte, *T) error
	Encode func(*T) ([]byte, error)
	Clone  func(*T) (*T, bool)
}

type Stats struct {
	Bytes     int64
	Items     int64
	Gets      int64
	Hits      int64
	Evictions int64
}

type Store[K comparable] interface {
	// GetCache returns the named cache previously created with NewCache,
	// or nil if there's no such namespace.
	GetCache(name string) Cache[K]
	// NewCache creates a new Cache namespace
	NewCache(name string, cacheBytes int64, getter Getter[K]) Cache[K]
	// DeregisterCache removes a Cache namespace
	DeregisterCache(name string)

	// SetLogger binds the Store and its Cache namespaces to a logger
	SetLogger(log slog.Logger)
}

type TSink[T any] interface {
	Sink

	// SetValue sets the value to the object v.
	// The caller retains ownership of v.
	SetValue(v *T, e time.Time) error

	// Value returns a copy of the object previously
	// stored in the Sink.
	Value() (*T, bool)
}

type Type int