@adventurelabs/scout-core 1.4.34 → 1.4.35

package/dist/hooks/useScoutRefresh.d.ts

@@ -3,6 +3,7 @@ export interface UseScoutRefreshOptions {
     onRefreshComplete?: () => void;
     cacheFirst?: boolean;
     cacheTtlMs?: number;
+    onlineRefetchMinIntervalMs?: number;
 }
 /**
  * Hook for refreshing scout data with detailed timing measurements and cache-first loading
@@ -12,6 +13,7 @@ export interface UseScoutRefreshOptions {
  * @param options.onRefreshComplete - Callback function called when refresh completes
  * @param options.cacheFirst - Whether to load from cache first, then refresh (default: true)
  * @param options.cacheTtlMs - Cache time-to-live in milliseconds (default: 24 hours)
+ * @param options.onlineRefetchMinIntervalMs - Min ms since last refresh before refetch on "online" (default: 60s)
  *
  * @returns Object containing:
  * - handleRefresh: Function to manually trigger a refresh

package/dist/hooks/useScoutRefresh.js

@@ -15,6 +15,7 @@ import { createBrowserClient } from "@supabase/ssr";
  * @param options.onRefreshComplete - Callback function called when refresh completes
  * @param options.cacheFirst - Whether to load from cache first, then refresh (default: true)
  * @param options.cacheTtlMs - Cache time-to-live in milliseconds (default: 24 hours)
+ * @param options.onlineRefetchMinIntervalMs - Min ms since last refresh before refetch on "online" (default: 60s)
  *
  * @returns Object containing:
  * - handleRefresh: Function to manually trigger a refresh
@@ -32,10 +33,12 @@ import { createBrowserClient } from "@supabase/ssr";
  */
 export function useScoutRefresh(options = {}) {
     const { autoRefresh = true, onRefreshComplete, cacheFirst = true, cacheTtlMs = 24 * 60 * 60 * 1000, // 24 hours default (1 day)
+    onlineRefetchMinIntervalMs = 60 * 1000, // 1 minute
      } = options;
     const dispatch = useAppDispatch();
     const store = useStore();
     const refreshInProgressRef = useRef(false);
+    const lastQueryAtRef = useRef(0);
     // Create Supabase client directly to avoid circular dependency
     // Assumes Next.js environment variables (NEXT_PUBLIC_*)
     const supabase = useMemo(() => {
@@ -306,6 +309,7 @@ export function useScoutRefresh(options = {}) {
         }
         finally {
             refreshInProgressRef.current = false;
+            lastQueryAtRef.current = Date.now();
         }
     }, [
         dispatch,
@@ -321,6 +325,19 @@ export function useScoutRefresh(options = {}) {
             handleRefresh();
         }
     }, [autoRefresh, handleRefresh]);
+    // Full refetch when nav goes online, only if min interval since last query has passed
+    useEffect(() => {
+        if (typeof window === "undefined")
+            return;
+        const handleOnline = () => {
+            const now = Date.now();
+            if (now - lastQueryAtRef.current >= onlineRefetchMinIntervalMs) {
+                handleRefresh();
+            }
+        };
+        window.addEventListener("online", handleOnline);
+        return () => window.removeEventListener("online", handleOnline);
+    }, [handleRefresh, onlineRefetchMinIntervalMs]);
     // Utility function to clear cache
     const clearCache = useCallback(async () => {
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adventurelabs/scout-core",
-  "version": "1.4.34",
+  "version": "1.4.35",
   "description": "Core utilities and helpers for Adventure Labs Scout applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",