@burdenoff/microfe-bigconsole 2026.1104.1 → 2026.1104.3

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

@@ -0,0 +1,26 @@
+/**
+ * Data sink owner (BOFF-10079).
+ *
+ * A manual sink for plan numbers (budget, targets) has no system of record, so
+ * the person accountable for its figures is recorded as `metadata.owner`. The
+ * sink's `metadata` JSON already round-trips through create, update and every
+ * read, so no schema change is needed.
+ *
+ * The update mutation REPLACES `metadata`, so an edit must merge the owner into
+ * the stored metadata rather than send `{ owner }` alone — other keys (source
+ * info, workflow config) would otherwise be wiped.
+ */
+/** Longest owner text accepted — a name, team or email, never a document. */
+export declare const SINK_OWNER_MAX_LENGTH = 120;
+/** The owner recorded on a sink, or '' when there is none. */
+export declare function readSinkOwner(metadata: Record<string, unknown> | null | undefined): string;
+/** Trim and cap owner input the way it will be stored. */
+export declare function normalizeSinkOwner(owner: string): string;
+/**
+ * Metadata with the owner set (or removed when blank), keeping every other
+ * key. Returns undefined when the result is empty and there was no metadata to
+ * begin with, so a create without an owner sends no metadata at all.
+ */
+export declare function withSinkOwner(metadata: Record<string, unknown> | null | undefined, owner: string): Record<string, unknown> | undefined;
+/** Whether the owner input differs from what is stored. */
+export declare function sinkOwnerChanged(metadata: Record<string, unknown> | null | undefined, owner: string): boolean;

package/dist/bigconsole/utils/dataSinkOwner.js

@@ -0,0 +1,17 @@
+var e = "owner";
+function t(t) {
+	let n = t?.[e];
+	return typeof n == "string" ? n.trim() : "";
+}
+function n(e) {
+	return e.trim().slice(0, 120);
+}
+function r(t, r) {
+	let i = { ...t ?? {} }, a = n(r);
+	if (a ? i[e] = a : delete i[e], !(Object.keys(i).length === 0 && !t)) return i;
+}
+function i(e, r) {
+	return t(e) !== n(r);
+}
+//#endregion
+export { n as normalizeSinkOwner, t as readSinkOwner, i as sinkOwnerChanged, r as withSinkOwner };

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/dist/bigconsole/utils/sinkWorkflowLink.d.ts

@@ -0,0 +1,14 @@
+import { DataSinkWorkflowLink, FluidGridsWorkflowStatus } from '../types';
+interface LinkableWorkflow {
+    id: string;
+    name: string;
+    key: string;
+    status: FluidGridsWorkflowStatus;
+}
+/**
+ * Workflows that can still be linked to the sink: not already linked (enabled
+ * or disabled — a disabled link is re-enabled from the workflow, not
+ * duplicated) and not archived. Sorted by name for a stable picker.
+ */
+export declare function linkableWorkflowsForSink<W extends LinkableWorkflow>(workflows: readonly W[], links: readonly Pick<DataSinkWorkflowLink, 'workflowId'>[] | undefined): W[];
+export {};

package/dist/bigconsole/utils/sinkWorkflowLink.js

@@ -0,0 +1,7 @@
+//#region src/bigconsole/utils/sinkWorkflowLink.ts
+function e(e, t) {
+	let n = new Set((t ?? []).map((e) => e.workflowId));
+	return e.filter((e) => e.status !== "archived" && !n.has(e.id)).sort((e, t) => (e.name || e.key).localeCompare(t.name || t.key));
+}
+//#endregion
+export { e as linkableWorkflowsForSink };

package/package.json

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