[API Proposal]: Allow to invalidate only local storage via HybridCache.RemoveAsync

[gurustron]

Background and motivation

Currently it is impossible to invalidate only local cache without rewriting the value via HybridCache.SetAsync. HybridCache.RemoveAsync will remove entry from both local and remote cache.

The main usage would be to provide user defined workaround until #5517 is designed and implemented and/or lazy approach for invalidation.

API Proposal

public enum HybridCacheRemoveMode 
{
     Full = 0,
     LocalOnly = 1     
}

And extend corresponding methods with it^

public class HybridCache
{
    public abstract ValueTask RemoveAsync(string key, HybridCacheRemoveMode mode = default, CancellationToken cancellationToken = default);
    // ....
}

API Usage

HybridCache hc = ...;
await hc.RemoveAsync("key", HybridCacheRemoveMode.LocalOnly);

Alternative Designs

No response

Risks

No response

[jodydonetti]

I would suggest not creating a new type and instead using the already existing HybridCacheEntryOptions for this: of course some members will not make sense on remove, but uniform is better imho (fwiw in FusionCache I did this).