[feat] Add Clear Cache functionality in AllDataBox component

- Implemented a method to clear the SObjects List cache and refresh the data.
- Added a button in the UI to trigger cache clearing when no matching objects are found.
- Updated state management to handle search query and match count in AllDataBoxSObject component.
- Enhanced troubleshooting documentation to guide users on clearing the cache from the Objects tab.

Author: tprouvot

addon/components/AlertBanner.js

@@ -15,7 +15,7 @@ class AlertBanner extends React.PureComponent {
         ),
         h("h2", {}, bannerText,
           h("p", {}, ""),
-          link.props ? h("a", link.props, link.text) : link.text
+          link && link.props ? h("a", link.props, link.text) : (link ? link.text : null)
         ),
         onClose && h("div", {className: "slds-notify__close"},
           h("button", {className: "slds-button slds-button_icon slds-button_icon-small slds-button_icon-inverse", title: "Close", onClick: onClose},

addon/popup.js

@@ -957,6 +957,7 @@ class AllDataBox extends React.PureComponent {
       contextSobject: null,
     };
     this.onAspectClick = this.onAspectClick.bind(this);
+    this.onClearSobjectsCache = this.onClearSobjectsCache.bind(this);
     this.parseContextUrl = this.ensureKnownBrowserContext.bind(this);
   }
 
@@ -1119,6 +1120,20 @@ class AllDataBox extends React.PureComponent {
       });
   }
 
+  async onClearSobjectsCache() {
+    const {sfHost} = this.props;
+    await DataCache.clearCache(Constants.CACHE_SOBJECTS_LIST, sfHost, true, true);
+    this.setState({sobjectsList: null, sobjectsLoading: false}, () => {
+      this.loadSobjects();
+    });
+    if (this.props.showToast) {
+      this.props.showToast({
+        type: "success",
+        bannerText: "SObjects List cache cleared.",
+      });
+    }
+  }
+
   render() {
     let {
       activeSearchAspect,
@@ -1234,6 +1249,8 @@ class AllDataBox extends React.PureComponent {
           contextSobject,
           linkTarget,
           onContextRecordChange,
+          onClearSobjectsCache: this.onClearSobjectsCache,
+          showToast: this.props.showToast,
           isFieldsPresent,
           eventMonitorHref,
         })
@@ -1580,9 +1597,19 @@ class AllDataBoxSObject extends React.PureComponent {
     this.state = {
       selectedValue: null,
       recordIdDetails: null,
+      searchQuery: "",
+      searchMatchCount: 0,
     };
     this.onDataSelect = this.onDataSelect.bind(this);
     this.getMatches = this.getMatches.bind(this);
+    this.onMatchingResultsChange = this.onMatchingResultsChange.bind(this);
+  }
+
+  onMatchingResultsChange(matchingResults, userQuery) {
+    this.setState({
+      searchQuery: userQuery || "",
+      searchMatchCount: matchingResults?.length ?? 0,
+    });
   }
 
   componentDidMount() {
@@ -1872,14 +1899,18 @@ class AllDataBoxSObject extends React.PureComponent {
       isFieldsPresent,
       eventMonitorHref,
     } = this.props;
-    let {selectedValue, recordIdDetails} = this.state;
+    let {selectedValue, recordIdDetails, searchQuery, searchMatchCount} = this.state;
+    let {onClearSobjectsCache} = this.props;
+    const cacheEnabled = isSettingEnabled(Constants.ENABLE_SOBJECTS_LIST_CACHE, true);
+    const showClearCacheButton = cacheEnabled && searchQuery.trim().length > 0 && searchMatchCount === 0;
     return h(
       "div",
       {className: "tab-container slds-p-horizontal_x-small"},
       h(AllDataSearch, {
         ref: "allDataSearch",
         sfHost,
         onDataSelect: this.onDataSelect,
+        onMatchingResultsChange: this.onMatchingResultsChange,
         sobjectsList,
         getMatches: this.getMatches,
         inputSearchDelay: 0,
@@ -2206,15 +2237,34 @@ class AllDataBoxSObject extends React.PureComponent {
                 )
               )
             ),
-            h(
-              "div",
-              {className: "slds-text-longform"},
-              h(
-                "h3",
-                {className: "slds-text-body_regular"},
-                "No record to display"
+            showClearCacheButton
+              ? h(
+                "div",
+                {className: "slds-text-longform slds-m-top_small slds-m-bottom_small"},
+                h(
+                  "p",
+                  {className: "slds-text-body_regular slds-m-bottom_xx-small"},
+                  "No matching objects found. Clear the cache to refresh the list and include newly created objects."
+                ),
+                h(
+                  "button",
+                  {
+                    className: "slds-button slds-button_neutral",
+                    onClick: onClearSobjectsCache,
+                    title: "Clear SObjects List cache and refresh"
+                  },
+                  "Clear Cache"
+                )
+              )
+              : h(
+                "div",
+                {className: "slds-text-longform"},
+                h(
+                  "h3",
+                  {className: "slds-text-body_regular"},
+                  "No record to display"
+                )
               )
-            )
           )
         )
     );
@@ -4420,7 +4470,7 @@ class AllDataSearch extends React.PureComponent {
   }
   getMatchesDelayed(userQuery) {
     let {queryDelayTimer} = this.state;
-    let {inputSearchDelay} = this.props;
+    let {inputSearchDelay, onMatchingResultsChange} = this.props;
 
     if (queryDelayTimer) {
       clearTimeout(queryDelayTimer);
@@ -4429,6 +4479,7 @@ class AllDataSearch extends React.PureComponent {
       let {getMatches} = this.props;
       const matchingResults = await getMatches(userQuery);
       await this.setState({matchingResults});
+      onMatchingResultsChange?.(matchingResults, userQuery);
     }, inputSearchDelay);
 
     this.setState({queryDelayTimer});

docs/troubleshooting.md

@@ -128,15 +128,22 @@ The extension caches the SObjects list to improve popup loading performance. Thi
 
 **How to solve it:**
 
-1. **Clear the SObjects List cache** (recommended for immediate results):
+1. **Clear the SObjects List cache from the Objects tab** (quickest when cache is enabled):
+   * Open the extension and go to the "Objects" tab
+   * Search for your new object name in the search field
+   * If no results appear, a "Clear Cache" button will be displayed
+   * Click the button to clear the cache and refresh the list
+   * Your new object should appear after the refresh
+
+2. **Clear the SObjects List cache from Options** (when the in-tab button is not shown, e.g. cache disabled):
    * Open the extension and click the "Options" button
    * Navigate to the "Cache" tab
-   * Find the "SObjects List Cache Duration (hours)" setting
+   * Find the "SObjects List Cache" setting
    * Click the "Clear Cache" button next to it
    * A success message will confirm the cache has been cleared
 
-2. **Wait for cache expiration**:
+3. **Wait for cache expiration**:
    * The cache will automatically expire based on the configured duration (default: 8 hours when "Preload SObjects before popup opens" is enabled, 168 hours / 7 days when disabled)
    * After expiration, the extension will fetch fresh data on the next popup open
 
-**Note:** The extension caches SObjects per org. If you switch between orgs, the extension uses the cache for the current org. For more details on cache configuration, see [SObjects List Cache Management](../how-to.md#sobjects-list-cache-management) in the how-to.
+**Note:** The "Clear Cache" button in the Objects tab is only displayed when SObjects List cache is enabled (Options > Cache tab) and a search returns no results. The extension caches SObjects per org. If you switch between orgs, the extension uses the cache for the current org. For more details on cache configuration, see [SObjects List Cache Management](../how-to.md#sobjects-list-cache-management) in the how-to.