cache

type Cache interface {
	Getter
	Setter
	SetIfAbsent(ctx context.Context, key string, value string, ttl time.Duration) (stored bool, err error)
	// AllowRateLimit consumes one token, refilling one token per interval up to burst.
	AllowRateLimit(
		ctx context.Context, key string, interval time.Duration, burst int, ttl time.Duration,
	) (allowed bool, err error)
	Invalidate(ctx context.Context, key string) error
}

type Engine interface {
	Cache
	Ping(ctx context.Context) error
	Shutdown(ctx context.Context) error
}

type Getter interface {
	Get(ctx context.Context, key string) (value string, found bool, err error)
}

type NoopCache struct{}

type Setter interface {
	Set(ctx context.Context, key string, value string, ttl time.Duration) error
}