@brownandroot/api 1.2.0 → 1.2.1

package/README.md

@@ -12,7 +12,7 @@ npm install @brownandroot/api
 
 ## Client-Side Cache API (recommended for SvelteKit)
 
-The package ships a browser-side API at `@brownandroot/api/cache` that wraps every remote function with an **IndexedDB stale-while-revalidate cache**. On the first call the data is fetched from the server; on every subsequent call the cached data is returned instantly and a background refresh keeps the cache warm.
+The package ships a browser-side API at `@brownandroot/api/cache` that wraps every remote function with an **IndexedDB stale-while-revalidate cache**. On the first call the data is fetched from the server; on every subsequent call the cached data is returned instantly. A background refresh runs automatically when the cached data is older than **4 hours**.
 
 All list and dropdown functions accept an optional filter object — every entity field is available as an optional filter key. The `q` field performs a case-insensitive partial-text match across the entity's searchable text fields.
 

package/dist/cache.js

@@ -18,13 +18,17 @@ import { getJobtypejobsteps as _getJobtypejobsteps, getJobtypejobstep as _getJob
 // ---------------------------------------------------------------------------
 // Internal: stale-while-revalidate fetch helpers
 // ---------------------------------------------------------------------------
+/** How long cached data is considered fresh before a background refresh is triggered. */
+const CACHE_TTL_MS = 4 * 60 * 60 * 1000; // 4 hours
 async function loadCached(store, fetcher) {
     const cached = await idbGet(store, 'all');
     if (cached) {
-        // Return stale data immediately; refresh in background for next call
-        fetcher()
-            .then((fresh) => idbSet(store, 'all', fresh))
-            .catch(() => { });
+        // Only refresh in the background if the cached data is older than the TTL
+        if (Date.now() - cached.fetchedAt >= CACHE_TTL_MS) {
+            fetcher()
+                .then((fresh) => idbSet(store, 'all', fresh))
+                .catch(() => { });
+        }
         return cached.data;
     }
     // Cache miss — must await

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@brownandroot/api",
-	"version": "1.2.0",
+	"version": "1.2.1",
 	"type": "module",
 	"repository": {
 		"type": "git",