@classytic/arc-next 0.14.0 → 0.15.0

package/dist/hooks.d.ts

@@ -90,6 +90,30 @@ interface CrudHooksConfig<T, TCreate = Partial<T>, TUpdate = Partial<T>> {
     gcTime?: number;
     refetchOnWindowFocus?: boolean;
     structuralSharing?: boolean;
+    /**
+     * Poll this resource's list/detail while mounted, in ms.
+     *
+     * Already supported PER CALL (`useList(params, { refetchInterval })`); this
+     * is the resource-level default, so a resource whose freshness matters
+     * declares it once instead of at every call site — and cannot be forgotten
+     * at one of them.
+     *
+     * The case that motivated it: an orders dashboard left open on a shop
+     * counter. Push notifications are best-effort, so the list is the
+     * AUTHORITATIVE path to a new order — but with no interval it relied on
+     * `refetchOnMount` / `refetchOnWindowFocus`, and a window that never blurs
+     * never refocuses, so it may never refetch. A missed push then reads as a
+     * missing record.
+     */
+    refetchInterval?: number | false;
+    /**
+     * Keep polling while the tab is hidden. Defaults to TanStack's `false`.
+     *
+     * Leave it off unless the data must be current the instant the operator
+     * returns — a background tab polling forever is load nobody is reading, and
+     * `refetchOnWindowFocus` already catches up on return.
+     */
+    refetchIntervalInBackground?: boolean;
     /**
      * Declare this resource's read endpoints PUBLIC (`allowPublic` on the
      * server — e.g. a storefront catalog). Read hooks then enable token-less

package/dist/hooks.js

@@ -146,8 +146,8 @@ function createCrudHooks({ api, entityKey, singular, plural, idField, defaults =
 				gcTime: queryOpts.gcTime ?? config.gcTime,
 				refetchOnWindowFocus: queryOpts.refetchOnWindowFocus ?? config.refetchOnWindowFocus,
 				structuralSharing: queryOpts.structuralSharing ?? config.structuralSharing,
-				refetchInterval: queryOpts.refetchInterval,
-				refetchIntervalInBackground: queryOpts.refetchIntervalInBackground
+				refetchInterval: queryOpts.refetchInterval ?? config.refetchInterval,
+				refetchIntervalInBackground: queryOpts.refetchIntervalInBackground ?? config.refetchIntervalInBackground
 			},
 			select: queryOpts.select
 		});
@@ -236,8 +236,8 @@ function createCrudHooks({ api, entityKey, singular, plural, idField, defaults =
 				gcTime: queryOpts.gcTime ?? config.gcTime,
 				refetchOnWindowFocus: queryOpts.refetchOnWindowFocus ?? config.refetchOnWindowFocus,
 				structuralSharing: queryOpts.structuralSharing ?? config.structuralSharing,
-				refetchInterval: queryOpts.refetchInterval,
-				refetchIntervalInBackground: queryOpts.refetchIntervalInBackground
+				refetchInterval: queryOpts.refetchInterval ?? config.refetchInterval,
+				refetchIntervalInBackground: queryOpts.refetchIntervalInBackground ?? config.refetchIntervalInBackground
 			},
 			select: queryOpts.select
 		});
@@ -589,8 +589,8 @@ function createCrudHooks({ api, entityKey, singular, plural, idField, defaults =
 				gcTime: queryOpts.gcTime ?? config.gcTime,
 				refetchOnWindowFocus: queryOpts.refetchOnWindowFocus ?? config.refetchOnWindowFocus,
 				structuralSharing: queryOpts.structuralSharing ?? config.structuralSharing,
-				refetchInterval: queryOpts.refetchInterval,
-				refetchIntervalInBackground: queryOpts.refetchIntervalInBackground
+				refetchInterval: queryOpts.refetchInterval ?? config.refetchInterval,
+				refetchIntervalInBackground: queryOpts.refetchIntervalInBackground ?? config.refetchIntervalInBackground
 			}
 		});
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/arc-next",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "React + TanStack Query SDK for Arc resources",
   "type": "module",
   "sideEffects": false,