@zauru-sdk/hooks 2.31.0 → 2.31.1

package/dist/catalogs.d.ts

@@ -15,8 +15,13 @@ type CatalogType<T> = {
  * otherParams: {
       includeDiscounts: "true",
     }
+ *
+ * staleWhileRevalidate: true — if Redux already has data, show it at once and
+ * refetch in the background; on success data is replaced silently, on error the
+ * cache is kept. When there is no cached data, behavior matches a normal load
+ * (loading true until the first response).
  */
-export declare function useGetReduxCatalog<T>(CATALOG_NAME: CATALOGS_NAMES, { online, wheres, otherParams }?: ReduxParamsConfig): CatalogType<T>;
+export declare function useGetReduxCatalog<T>(CATALOG_NAME: CATALOGS_NAMES, { online, staleWhileRevalidate, wheres, otherParams, }?: ReduxParamsConfig): CatalogType<T>;
 /**
  *
  * ======================= HOOKS

package/dist/esm/catalogs.js

@@ -17,8 +17,13 @@ const redux_1 = require("@zauru-sdk/redux");
  * otherParams: {
       includeDiscounts: "true",
     }
+ *
+ * staleWhileRevalidate: true — if Redux already has data, show it at once and
+ * refetch in the background; on success data is replaced silently, on error the
+ * cache is kept. When there is no cached data, behavior matches a normal load
+ * (loading true until the first response).
  */
-function useGetReduxCatalog(CATALOG_NAME, { online = false, wheres = [], otherParams } = {}) {
+function useGetReduxCatalog(CATALOG_NAME, { online = false, staleWhileRevalidate = false, wheres = [], otherParams, } = {}) {
     const dispatch = (0, redux_1.useAppDispatch)();
     const fetcher = (0, react_1.useFetcher)();
     const [fetchTriggered, setFetchTriggered] = (0, react_2.useState)(false);
@@ -36,14 +41,28 @@ function useGetReduxCatalog(CATALOG_NAME, { online = false, wheres = [], otherPa
          * Lógica:
          * - Si `online: true`, forzamos el fetch.
          * - Si `reFetch: true`, también forzamos el fetch.
-         * - Si `online: false` y SÍ tenemos data local, NO hacemos fetch (solo mostramos lo que hay).
-         * - Si `online: false` y NO hay data local, SÍ hacemos fetch (porque no hay nada que mostrar).
+         * - Si `staleWhileRevalidate: true` y hay data en Redux, forzamos fetch en segundo plano
+         *   sin poner `loading: true` (se muestra la caché hasta que llegue respuesta o falle).
+         * - Si `online: false` y SÍ tenemos data local y no aplica lo anterior, NO hacemos fetch.
+         * - Si no hay data local, SÍ hacemos fetch (porque no hay nada que mostrar).
          */
         (0, react_2.useEffect)(() => {
-            const mustFetch = online || catalogData?.reFetch || !hasLocalData;
+            const revalidateInBackground = Boolean(staleWhileRevalidate) && hasLocalData;
+            const mustFetch = online ||
+                catalogData?.reFetch ||
+                !hasLocalData ||
+                revalidateInBackground;
             if (mustFetch) {
-                setData((prev) => ({ ...prev, loading: true }));
-                dispatch((0, redux_1.catalogsFetchStart)(CATALOG_NAME));
+                if (revalidateInBackground) {
+                    setData({
+                        data: catalogData?.data || [],
+                        loading: false,
+                    });
+                }
+                else {
+                    setData((prev) => ({ ...prev, loading: true }));
+                    dispatch((0, redux_1.catalogsFetchStart)(CATALOG_NAME));
+                }
                 // Construimos el query para `wheres` y `otherParams`
                 const encodedWheres = (wheres || []).map((where) => encodeURIComponent(where));
                 const wheresQueryParam = encodedWheres.join("&");
@@ -93,7 +112,7 @@ function useGetReduxCatalog(CATALOG_NAME, { online = false, wheres = [], otherPa
                 });
             }
             // eslint-disable-next-line react-hooks/exhaustive-deps
-        }, [online, catalogData?.reFetch, hasLocalData]);
+        }, [online, staleWhileRevalidate, catalogData?.reFetch, hasLocalData]);
         /**
          * Efecto que observa la finalización del fetch (fetcher.state === "idle")
          * y decide qué hacer con la data o error recibidos.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zauru-sdk/hooks",
-  "version": "2.31.0",
+  "version": "2.31.1",
   "description": "Hooks reutilizables dentro de las webapps de Zauru.",
   "main": "./dist/esm/index.js",
   "module": "./dist/esm/index.js",
@@ -28,10 +28,10 @@
     "@remix-run/react": "^2.8.1",
     "@zauru-sdk/common": "^2.30.0",
     "@zauru-sdk/icons": "^2.0.188",
-    "@zauru-sdk/redux": "^2.31.0",
+    "@zauru-sdk/redux": "^2.31.1",
     "@zauru-sdk/types": "^2.30.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
-  "gitHead": "2f9ee02a1ef76fbf71637b8455e4840786489628"
+  "gitHead": "220d939967adc34a44c6cf0671f0234253bbfa45"
 }