Add manual refresh and tracking utilities for RSS/Atom collections

Co-authored-by: sam.willis <[email protected]>

Author: cursoragent

docs/overview.md

@@ -362,6 +362,19 @@ Optional configuration includes:
 
 RSS and Atom collections automatically handle feed parsing, deduplication of items, and provide built-in error recovery. The collections will continue polling even after network failures or parsing errors.
 
+Collections can be manually refreshed when needed:
+
+```ts
+// Manually refresh the feed data
+await blogFeed.utils.refresh()
+
+// Clear deduplication cache if needed
+blogFeed.utils.clearSeenItems()
+
+// Check how many items have been tracked
+console.log(`Tracked items: ${blogFeed.utils.getSeenItemsCount()}`)
+```
+
 #### `LocalStorageCollection`
 
 localStorage collections store small amounts of local-only state that persists across browser sessions and syncs across browser tabs in real-time. All data is stored under a single localStorage key and automatically synchronized using storage events.

packages/rss-db-collection/README.md

@@ -5,7 +5,7 @@ RSS/Atom feed collection for TanStack DB - sync data from RSS and Atom feeds wit
 ## Features
 
 - **📡 RSS & Atom Support**: Dedicated option creators for RSS 2.0 and Atom 1.0 feeds
-- **🔄 Automatic Polling**: Configurable polling intervals with intelligent error recovery
+- **🔄 Automatic Polling**: Configurable polling intervals with intelligent error recovery and manual refresh capability
 - **✨ Deduplication**: Built-in deduplication based on feed item IDs/GUIDs
 - **🔧 Transform Functions**: Custom transform functions to normalize feed data to your schema
 - **📝 Full TypeScript Support**: Complete type safety with schema inference