@burdenoff/microfe-bigconsole 2026.1103.11 → 2026.1104.2

package/dist/bigconsole/utils/liveBoardRefresh.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Live board refresh cadence (BOFF-10201).
+ *
+ * While GO LIVE is on, the dashboard view refetches two things:
+ *
+ *  - the board STRUCTURE (dashboard + widget list) every few seconds, so new
+ *    widgets and pages appear without a reload;
+ *  - every on-screen widget's DATA (`GetWidget`), so a changed sink payload
+ *    shows up within seconds.
+ *
+ * The widget list (`WidgetListFields`) carries no data, so before this change
+ * GO LIVE only refreshed structure and the numbers moved on each widget's own
+ * `refreshInterval` — 300s on generated boards, never when it is 0. A wall
+ * display therefore lagged a sink change by up to five minutes.
+ *
+ * The data cadence matches fe-libs' short-lived GraphQL read cache
+ * (`RECENT_QUERY_CACHE_TTL_MS`, 15s): refetching any faster would be answered
+ * from that cache and add requests without adding freshness.
+ */
+/** How often live mode refetches the dashboard and widget list. */
+export declare const LIVE_STRUCTURE_POLL_MS = 3500;
+/** How often live mode refetches every visible widget's data. */
+export declare const LIVE_DATA_REFRESH_MS = 15000;
+/** Whole seconds of the data cadence, for user-facing copy. */
+export declare const LIVE_DATA_REFRESH_SECONDS: number;
+/**
+ * Whether the live data refetch is due. `lastRefreshAt` is null before the
+ * first refetch, which is always due so the board catches up the moment live
+ * mode is switched on or the tab becomes visible again.
+ */
+export declare function isLiveDataRefreshDue(lastRefreshAt: number | null, now: number): boolean;

package/dist/bigconsole/utils/liveBoardRefresh.js

@@ -0,0 +1,7 @@
+//#region src/bigconsole/utils/liveBoardRefresh.ts
+var e = 3500, t = 15e3, n = Math.round(t / 1e3);
+function r(e, n) {
+	return e === null || n - e >= t;
+}
+//#endregion
+export { t as LIVE_DATA_REFRESH_MS, n as LIVE_DATA_REFRESH_SECONDS, e as LIVE_STRUCTURE_POLL_MS, r as isLiveDataRefreshDue };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/microfe-bigconsole",
-  "version": "2026.1103.11",
+  "version": "2026.1104.2",
   "description": "BigConsole - AI-powered analytics and dashboard platform",
   "type": "module",
   "files": [