cache

type Cache[T any] interface {
	Get(ctx context.Context, k Key) (T, bool)
	// Stamp returns how many times database was invalidated. A reader takes
	// it before querying and passes it to Set, which stores nothing when the
	// database was invalidated meanwhile: the result may predate the write.
	Stamp(database string) uint64
	Set(ctx context.Context, k Key, v T, stamp uint64) error
	// Invalidate drops the entries reading relation of database and every
	// derived entry of database; an empty relation drops all of database.
	Invalidate(database, relation string) error
}

type InvalidateOnly[T any] struct{ Cache Cache[T] }

type Key struct {
	// Database is the physical database the entry reads: invalidation
	// matches it across datasources and configuration generations.
	Database string
	Relation string
	// Datasource and Generation keep lookups apart: datasources may reach
	// one database through accounts that see different rows, and a reloaded
	// configuration may read it under different rules.
	Datasource string
	Generation uint64
	SQL        string
	Args       string
	Scope      string
}

type NoopCache[T any] struct{}

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