put method
Stores or updates an entry by key.
Implementation
@override
Future<void> put(String key, CacheEntry entry) async {
// Evict least-recently-used entry if at capacity
if (_entries.length >= maxEntries && !_entries.containsKey(key)) {
final lruKey = _entries.keys.first;
_evictions++;
await delete(lruKey);
}
// Clean up previous tags if overwriting an existing key
final existing = _entries[key];
if (existing != null) {
_unindexTags(key, existing.tags);
}
_entries[key] = entry;
for (final tag in entry.tags) {
_tagIndex.putIfAbsent(tag, () => <String>{}).add(key);
}
}