Add per-section clearing and dismissed suggestions to snippets-internals

components/ntp_snippets/content_suggestions_service.h

 // Copyright 2016 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef COMPONENTS_NTP_SNIPPETS_CONTENT_SUGGESTIONS_SERVICE_H_
 #define COMPONENTS_NTP_SNIPPETS_CONTENT_SUGGESTIONS_SERVICE_H_
 
 #include <map>
 #include <memory>
 #include <string>
@@ skipping 87 matching lines @@
   void AddObserver(Observer* observer);
   void RemoveObserver(Observer* observer);
 
   // Registers a new ContentSuggestionsProvider. It must be ensured that at most
   // one provider is registered for every category and that this method is
   // called only once per provider.
   void RegisterProvider(std::unique_ptr<ContentSuggestionsProvider> provider);
 
   // Only for debugging use through the internals page.
   // Removes all suggestions from all caches or internal stores in all
-  // providers. It does, however, not remove any suggestions from the provider's
-  // sources, so if their configuration hasn't changed, they should return the
-  // same results when they fetch the next time. In particular, calling this
-  // method will not mark any suggestions as dismissed.
-  void ClearCachedSuggestionsForDebugging();
+  // providers. See |ClearCachedSuggestionsForDebugging|.
+  void ClearAllCachedSuggestionsForDebugging();
+
+  // Only for debugging use through the internals page.
+  // Removes all suggestions of the given |category| from all caches or internal
+  // stores in the service and the corresponding provider. It does, however, not
+  // remove any suggestions from the provider's sources, so if its configuration
+  // hasn't changed, it might return the same results when it fetches the next
+  // time. In particular, calling this method will not mark any suggestions as
+  // dismissed.
+  void ClearCachedSuggestionsForDebugging(Category category);
+
+  // Only for debugging use through the internals page.
+  // Retrieves suggestions of the given |category| that have previously been
+  // dismissed and are still stored in the respective provider. If the
+  // provider doesn't store dismissed suggestions, this returns an empty vector.
+  std::vector<ContentSuggestion> GetDismissedSuggestionsForDebugging(
+      Category category);
 
   // Only for debugging use through the internals page. Some providers
   // internally store a list of dismissed suggestions to prevent them from
-  // reappearing. This function clears all such lists in all providers, making
-  // dismissed suggestions reappear (only for certain providers).
-  void ClearDismissedSuggestionsForDebugging();
+  // reappearing. This function clears all suggestions of the given |category|
+  // from such lists, making dismissed suggestions reappear (if the provider
+  // supports it).
+  void ClearDismissedSuggestionsForDebugging(Category category);
 
   CategoryFactory* category_factory() { return &category_factory_; }
 
   // The reference to the NTPSnippetsService provider should only be set by the
   // factory and only be used for scheduling, periodic fetching and debugging.
   NTPSnippetsService* ntp_snippets_service() { return ntp_snippets_service_; }
   void set_ntp_snippets_service(NTPSnippetsService* ntp_snippets_service) {
     ntp_snippets_service_ = ntp_snippets_service;
   }
 
@@ skipping 64 matching lines @@
   // background fetching and debugging calls to it. If the NTPSnippetsService is
   // loaded, it is also present in |providers_|, otherwise this is a nullptr.
   NTPSnippetsService* ntp_snippets_service_;
 
   DISALLOW_COPY_AND_ASSIGN(ContentSuggestionsService);
 };
 
 }  // namespace ntp_snippets
 
 #endif  // COMPONENTS_NTP_SNIPPETS_CONTENT_SUGGESTIONS_SERVICE_H_