smartcache

type CacheControl struct {
	MaxAge          time.Duration
	SMaxAge         time.Duration
	NoCache         bool
	NoStore         bool
	Public          bool
	Private         bool
	Immutable       bool
	MustRevalidate  bool
	ProxyRevalidate bool
	NoTransform     bool
	StaleIfError    time.Duration
}

type Config struct {
	// Store is the cache backend. Default: kv.NewMemoryStore sized to
	// MaxSize. Pass any kv.Store implementation when constructing the
	// middleware; file-backed stores should be constructed with
	// kv.WithMaxEntrySize(maxCacheEntrySize) to bound persisted entry size.
	Store kv.Store

	// Methods is the list of HTTP methods to cache. Default: ["GET"].
	Methods []string

	// CacheableStatusCodes is the list of status codes to cache. Default: [200].
	CacheableStatusCodes []int

	// MaxSize is the maximum number of cached responses. Default: 10000.
	MaxSize int

	// DefaultTTL is the default TTL when Cache-Control is not set. Default: 5m.
	DefaultTTL time.Duration

	// MaxBodySize is the maximum response body size to cache. Default: 1MB.
	MaxBodySize int

	// Next is an optional skip function.
	Next func(ctx fh.Ctx) bool

	// KeyFunc generates a cache key from the request. Default: method + path + query.
	KeyFunc func(ctx fh.Ctx) string

	// VaryHeaders lists additional request headers folded into the cache
	// key (e.g. "Accept-Encoding", "Accept-Language") so a response cached
	// for one variant (compressed, localized, ...) is never served to a
	// request that asked for a different one.
	VaryHeaders []string

	// AllowRequestCookies permits caching/serving requests that carry a
	// Cookie header. Default false: requests with an Authorization or
	// Cookie header are never read from or written to the shared cache,
	// since a personalized/authenticated response could otherwise be
	// cached and served to a different caller on the same path.
	AllowRequestCookies bool
}

type Response struct {
	StatusCode int
	Headers    map[string][]string
	Body       []byte
	ETag       string
	LastMod    time.Time
	Expires    time.Time
	CC         CacheControl
	Stored     time.Time
}