cache

type Cache[T any] interface {
	// Get retrieves the value associated with the given key.
	Get(ctx context.Context, key string) (T, error)

	// GetAndDelete retrieves the value associated with the given key and deletes it.
	GetAndDelete(ctx context.Context, key string) (T, error)

	// Exists checks if a value exists for the given key.
	Exists(ctx context.Context, key string) error

	// Set sets the value for the given key.
	Set(ctx context.Context, key string, value T, expiration ...time.Duration) error

	// Delete deletes the value associated with the given key.
	Delete(ctx context.Context, key string) error

	// Iterator iterates over all key-value pairs in the cache.
	Iterator(ctx context.Context, fn func(ctx context.Context, key string, value T) bool) error

	// Close releases any resources associated with the cache.
	Close(ctx context.Context) error
}

type NSCache[T any] interface {
	// Get retrieves the value associated with the given key in the specified namespace.
	Get(ctx context.Context, ns, key string) (T, error)

	// GetAndDelete retrieves the value associated with the given key in the specified namespace and deletes it.
	GetAndDelete(ctx context.Context, ns, key string) (T, error)

	// Exists checks if a value exists for the given key in the specified namespace.
	Exists(ctx context.Context, ns, key string) error

	// Set sets the value for the given key in the specified namespace.
	Set(ctx context.Context, ns, key string, value T, expiration ...time.Duration) error

	// Delete deletes the value associated with the given key in the specified namespace.
	Delete(ctx context.Context, ns, key string) error

	// Iterator iterates over all key-value pairs in the specified namespace.
	Iterator(ctx context.Context, ns string, fn func(ctx context.Context, key string, value T) bool) error

	// Close releases any resources associated with the cache.
	Close(ctx context.Context) error
}

type ObjectCache interface {
	// Get retrieves the value associated with the given key.
	Get(ctx context.Context, key string) (any, error)

	// GetAndDelete retrieves the value associated with the given key and deletes it.
	GetAndDelete(ctx context.Context, key string) (any, error)

	// Exists checks if a value exists for the given key.
	Exists(ctx context.Context, key string) error

	// Set sets the value for the given key.
	Set(ctx context.Context, key string, value any, expiration ...time.Duration) error

	// Delete deletes the value associated with the given key.
	Delete(ctx context.Context, key string) error

	// Iterator iterates over all key-value pairs in the cache.
	Iterator(ctx context.Context, fn func(ctx context.Context, key string, value any) bool) error

	// Close releases any resources associated with the cache.
	Close(ctx context.Context) error
}

type ObjectNSCache interface {
	// Get retrieves the value associated with the given key in the specified namespace.
	Get(ctx context.Context, ns, key string) (any, error)

	// GetAndDelete retrieves the value associated with the given key in the specified namespace and deletes it.
	GetAndDelete(ctx context.Context, ns, key string) (any, error)

	// Exists checks if a value exists for the given key in the specified namespace.
	Exists(ctx context.Context, ns, key string) error

	// Set sets the value for the given key in the specified namespace.
	Set(ctx context.Context, ns, key string, value any, expiration ...time.Duration) error

	// Delete deletes the value associated with the given key in the specified namespace.
	Delete(ctx context.Context, ns, key string) error

	// Iterator iterates over all key-value pairs in the specified namespace.
	Iterator(ctx context.Context, ns string, fn func(ctx context.Context, key string, value any) bool) error

	// Close releases any resources associated with the cache.
	Close(ctx context.Context) error
}

type Option struct {
	// Joint is the separator used in cache key generation.
	Concat func(ns, key string) string
}