caches

type Cacher interface {
	// Get impl should check if a specific key exists in the cache and return its value
	// look at Query.Marshal
	Get(ctx context.Context, key string, q *Query[any]) (*Query[any], error)
	// Store impl should store a cached representation of the val param
	// look at Query.Unmarshal
	Store(ctx context.Context, key string, val *Query[any]) error
	// Invalidate impl should invalidate cached values based on the given event.
	// The event contains metadata about the mutation (tables, entity IDs, mutation type, and tags).
	// It will be called when INSERT / UPDATE / DELETE queries are sent to the DB.
	Invalidate(ctx context.Context, event *InvalidationEvent) error
}

type Caches struct {
	Conf *Config
	// contains filtered or unexported fields
}

type Config struct {
	Easer    bool
	Cacher   Cacher
	TagsFunc func(db *gorm.DB) []string
	// SkipFunc, when set, is consulted on every SELECT before the cache
	// lookup. Returning true bypasses the plugin entirely for that query:
	// no cache read, no cache write and no easer dedup — the query always
	// hits the database. Statement.SQL and Statement.Table are already
	// resolved when it is called.
	//
	// Note: returning nil from TagsFunc does NOT skip caching — it only
	// stores the entry untagged (and therefore not invalidatable by tag).
	// Use SkipFunc to exclude tables from the cache.
	SkipFunc func(db *gorm.DB) bool
	Prefix   string
}

type InvalidationEvent struct {
	Tables       []string
	EntityIDs    []interface{}
	MutationType MutationType
	Tags         []string
}

type MutationType int

type Query[T any] struct {
	Dest         T
	RowsAffected int64
}