feat: add cache management methods for invalidating and clearing cached results in StoreComponentWithUtilities

Author: mashrulhaque

README.md

@@ -363,17 +363,24 @@ var user = await LazyLoad($"user-{userId}", () => UserService.GetUserAsync(userI
 
 #### Cache Invalidation
 
-Control cached entries when data changes:
+Control cached entries when data changes (in components inheriting `StoreComponentWithUtilities<TState>`):
 
 ```csharp
 // Remove specific cached entry
-executor.InvalidateCache($"product-{productId}");
+InvalidateCachedResult($"product-{productId}");
 
 // Remove all entries with prefix (e.g., after bulk operation)
-executor.InvalidateCacheByPrefix("product-");
+InvalidateCachedResultsByPrefix("product-");
 
 // Clear all cached results (e.g., on user logout)
-executor.ClearCache();
+ClearCachedResults();
+```
+
+Or access the executor directly:
+```csharp
+AsyncExecutor?.InvalidateCache($"product-{productId}");
+AsyncExecutor?.InvalidateCacheByPrefix("product-");
+AsyncExecutor?.ClearCache();
 ```
 
 > **Note:** Only the first caller's callbacks (loading, success, error) are executed. Concurrent callers receive the same result but their callbacks are NOT invoked. This is intentional for deduplication.

docs-site/api-reference.html

@@ -918,14 +918,18 @@ <h4><code>ExecuteCachedAsync&lt;TResult&gt;</code></h4>
               </div>
 
               <h3>Cache Management Methods</h3>
+              <p>These methods are available on <code>IAsyncActionExecutor&lt;TState&gt;</code>. Components inheriting from <code>StoreComponentWithUtilities&lt;TState&gt;</code> also have convenience wrapper methods: <code>InvalidateCachedResult()</code>, <code>InvalidateCachedResultsByPrefix()</code>, and <code>ClearCachedResults()</code>.</p>
 
               <div class="api-section">
                 <h4><code>InvalidateCache(string cacheKey)</code></h4>
                 <p>Removes a specific cached result by key. Use this when you know the exact cache key to invalidate.</p>
+                <p><strong>Component wrapper:</strong> <code>InvalidateCachedResult(cacheKey)</code></p>
                 <div class="code-block">
-                  <pre><code class="language-csharp">// After updating a product, invalidate its cache
-await productService.UpdateProductAsync(product);
-asyncExecutor.InvalidateCache($"product-{productId}");</code></pre>
+                  <pre><code class="language-csharp">// In a component (using wrapper method)
+InvalidateCachedResult($"product-{productId}");
+
+// Or using executor directly
+AsyncExecutor?.InvalidateCache($"product-{productId}");</code></pre>
                 </div>
                 <p><strong>Behavior:</strong></p>
                 <ul>
@@ -938,10 +942,10 @@ <h4><code>InvalidateCache(string cacheKey)</code></h4>
               <div class="api-section">
                 <h4><code>InvalidateCacheByPrefix(string prefix)</code></h4>
                 <p>Removes all cached results with keys starting with the specified prefix. Useful for invalidating related cache entries.</p>
+                <p><strong>Component wrapper:</strong> <code>InvalidateCachedResultsByPrefix(prefix)</code></p>
                 <div class="code-block">
-                  <pre><code class="language-csharp">// After adding a new product, invalidate all product caches
-await productService.CreateProductAsync(newProduct);
-asyncExecutor.InvalidateCacheByPrefix("product-");
+                  <pre><code class="language-csharp">// In a component (using wrapper method)
+InvalidateCachedResultsByPrefix("product-");
 
 // Invalidates: "product-1", "product-2", "product-list", etc.</code></pre>
                 </div>
@@ -967,10 +971,13 @@ <h4><code>InvalidateCacheByPrefix(string prefix)</code></h4>
               <div class="api-section">
                 <h4><code>ClearCache()</code></h4>
                 <p>Clears all cached results. Use this sparingly, typically only for global state resets.</p>
+                <p><strong>Component wrapper:</strong> <code>ClearCachedResults()</code></p>
                 <div class="code-block">
-                  <pre><code class="language-csharp">// Clear all caches on logout
-await authService.LogoutAsync();
-asyncExecutor.ClearCache();</code></pre>
+                  <pre><code class="language-csharp">// In a component (using wrapper method)
+ClearCachedResults();
+
+// Or using executor directly
+AsyncExecutor?.ClearCache();</code></pre>
                 </div>
                 <p><strong>When to use:</strong></p>
                 <ul>
@@ -994,23 +1001,23 @@ <h4>Cache Management Best Practices</h4>
                   <tbody>
                     <tr>
                       <td>Single item updated</td>
-                      <td><code>InvalidateCache("item-{id}")</code></td>
+                      <td><code>InvalidateCachedResult("item-{id}")</code></td>
                     </tr>
                     <tr>
                       <td>Multiple related items changed</td>
-                      <td><code>InvalidateCacheByPrefix("category-")</code></td>
+                      <td><code>InvalidateCachedResultsByPrefix("category-")</code></td>
                     </tr>
                     <tr>
                       <td>User logout</td>
-                      <td><code>ClearCache()</code></td>
+                      <td><code>ClearCachedResults()</code></td>
                     </tr>
                     <tr>
                       <td>List item added/removed</td>
-                      <td><code>InvalidateCacheByPrefix("list-")</code></td>
+                      <td><code>InvalidateCachedResultsByPrefix("list-")</code></td>
                     </tr>
                     <tr>
                       <td>Settings changed</td>
-                      <td><code>InvalidateCacheByPrefix("settings-")</code></td>
+                      <td><code>InvalidateCachedResultsByPrefix("settings-")</code></td>
                     </tr>
                   </tbody>
                 </table>
@@ -1125,15 +1132,15 @@ <h2 id="quick-reference">Quick Reference</h2>
                     <td>Validate state integrity</td>
                   </tr>
                   <tr>
-                    <td><code>InvalidateCache()</code></td>
+                    <td><code>InvalidateCachedResult()</code></td>
                     <td>Remove specific cached result</td>
                   </tr>
                   <tr>
-                    <td><code>InvalidateCacheByPrefix()</code></td>
+                    <td><code>InvalidateCachedResultsByPrefix()</code></td>
                     <td>Remove cached results by prefix</td>
                   </tr>
                   <tr>
-                    <td><code>ClearCache()</code></td>
+                    <td><code>ClearCachedResults()</code></td>
                     <td>Clear all cached results</td>
                   </tr>
                 </tbody>

docs-site/async-helpers/execute-cached-async.html

@@ -240,6 +240,7 @@ <h2>API Reference</h2>
               </table>
 
               <h3>Cache Invalidation Methods</h3>
+              <p>Available in components inheriting <code>StoreComponentWithUtilities&lt;TState&gt;</code>:</p>
 
               <table class="table">
                 <thead>
@@ -250,19 +251,21 @@ <h3>Cache Invalidation Methods</h3>
                 </thead>
                 <tbody>
                   <tr>
-                    <td><code>InvalidateCache(string cacheKey)</code></td>
+                    <td><code>InvalidateCachedResult(string cacheKey)</code></td>
                     <td>Removes a specific cache entry by key. Use after edit/delete operations to force fresh data on next call.</td>
                   </tr>
                   <tr>
-                    <td><code>InvalidateCacheByPrefix(string prefix)</code></td>
-                    <td>Removes all cache entries matching the prefix. Example: <code>InvalidateCacheByPrefix("product-")</code> clears all product caches.</td>
+                    <td><code>InvalidateCachedResultsByPrefix(string prefix)</code></td>
+                    <td>Removes all cache entries matching the prefix. Example: <code>InvalidateCachedResultsByPrefix("product-")</code> clears all product caches.</td>
                   </tr>
                   <tr>
-                    <td><code>ClearCache()</code></td>
+                    <td><code>ClearCachedResults()</code></td>
                     <td>Removes all cache entries. Use on logout or when global state reset is needed.</td>
                   </tr>
                 </tbody>
               </table>
+
+              <p class="text-muted">You can also access the executor directly via <code>AsyncExecutor?.InvalidateCache()</code>, <code>AsyncExecutor?.InvalidateCacheByPrefix()</code>, and <code>AsyncExecutor?.ClearCache()</code>.</p>
             </section>
 
             <!-- When to Use -->
@@ -427,7 +430,7 @@ <h2>Cache Invalidation</h2>
 await ProductApi.UpdateAsync(product);
 
 // Force fresh data on next ExecuteCachedAsync call
-InvalidateCache($"product-{product.Id}");
+InvalidateCachedResult($"product-{product.Id}");
 
 // Next component that calls ExecuteCachedAsync will fetch fresh data
 await ExecuteCachedAsync(
@@ -444,10 +447,10 @@ <h2>Cache Invalidation</h2>
 await ProductApi.BulkUpdateAsync(products);
 
 // Clear all product-related caches
-InvalidateCacheByPrefix("product-");
+InvalidateCachedResultsByPrefix("product-");
 
 // Or clear category-specific caches
-InvalidateCacheByPrefix($"category-{categoryId}-products");</code></pre>
+InvalidateCachedResultsByPrefix($"category-{categoryId}-products");</code></pre>
               </div>
 
               <div class="code-block">
@@ -458,7 +461,7 @@ <h2>Cache Invalidation</h2>
     await AuthApi.LogoutAsync();
 
     // Clear all cached data
-    ClearCache();
+    ClearCachedResults();
 
     // Reset state
     await UpdateAsync(_ => AppState.Initial);
@@ -469,7 +472,7 @@ <h2>Cache Invalidation</h2>
 // On global state reset
 public async Task ResetApplicationAsync()
 {
-    ClearCache();
+    ClearCachedResults();
     await UpdateAsync(_ => AppState.Initial);
 }</code></pre>
               </div>

src/EasyAppDev.Blazor.Store/Blazor/StoreComponentWithUtilities.cs

@@ -356,6 +356,42 @@ protected Task ExecuteCachedAsync<TResult>(
         return AsyncExecutor.ExecuteCachedAsync(cacheKey, asyncAction, loading, success, error, cacheFor, cancellationToken, action);
     }
 
+    /// <summary>
+    /// Invalidates a cached result from ExecuteCachedAsync by its cache key.
+    /// </summary>
+    /// <param name="cacheKey">The cache key to invalidate.</param>
+    /// <remarks>
+    /// This only affects cached results, not in-flight operations.
+    /// The next call to ExecuteCachedAsync with this key will execute the async action again.
+    /// </remarks>
+    protected void InvalidateCachedResult(string cacheKey)
+    {
+        AsyncExecutor?.InvalidateCache(cacheKey);
+    }
+
+    /// <summary>
+    /// Invalidates all cached results from ExecuteCachedAsync with keys starting with the specified prefix.
+    /// </summary>
+    /// <param name="prefix">The prefix to match cache keys against.</param>
+    /// <remarks>
+    /// Useful for invalidating related cache entries (e.g., "product-" invalidates "product-1", "product-2", etc.).
+    /// </remarks>
+    protected void InvalidateCachedResultsByPrefix(string prefix)
+    {
+        AsyncExecutor?.InvalidateCacheByPrefix(prefix);
+    }
+
+    /// <summary>
+    /// Clears all cached results from ExecuteCachedAsync.
+    /// </summary>
+    /// <remarks>
+    /// This only affects cached results, not in-flight operations.
+    /// </remarks>
+    protected void ClearCachedResults()
+    {
+        AsyncExecutor?.ClearCache();
+    }
+
     /// <summary>
     /// Loads data with automatic caching and request deduplication.
     /// </summary>