cache

May 20, 2026

Changes in this version

+ const Version

+ var ErrCacheMiss = errors.New("cache: miss")

+ var ErrInstanceMismatch = errors.New("cache: envelope instance does not match locator")

+ var ErrInvalidName = errors.New("cache: unsafe path component")

+ var ErrInvalidRoot = errors.New("cache: locator root must be a non-empty absolute path")

+ func Age(fetchedAt, now time.Time) string

+ func WriteEnvelope[T any](loc Locator, env Envelope[T]) error

+ func WriteResource[T any](loc Locator, name, ttl string, data T) error

+ type Envelope struct

+ Data T

+ FetchedAt time.Time

+ Instance string

+ Resource string

+ TTL string

+ Version int

+ func ReadResource[T any](loc Locator, name string) (Envelope[T], error)

+ type Locator struct

+ InstanceKey string

+ Root string

+ type Status int

+ const StatusFresh

+ const StatusManual

+ const StatusStale

+ const StatusUnavailable

+ const StatusUninitialized

+ func Classify(fetchedAt time.Time, ttl string, now time.Time) Status

+ func (s Status) String() string