@burdenoff/microfe-bigconsole 2026.1104.2 → 2026.1104.4

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/parserTestGate.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Parser wizard test gate (BOFF-10084).
+ *
+ * "Parsers you can test before you trust": the Expression & Test step must not
+ * be left, and the parser not created, until the CURRENT expression has passed
+ * a test. A test belongs to the exact (type, expression) pair it ran on, so
+ * editing the expression or switching JQ ↔ JSONata after a pass needs a new
+ * run; a failed run clears the pass.
+ *
+ * Users who may not run tests (no `bigconsole-parser:test`) cannot satisfy the
+ * gate, so for them it degrades to a warning instead of a dead end.
+ */
+/** Identity of what a test ran on: the parser type and the trimmed expression. */
+export declare function parserTestSignature(type: string, expression: string): string;
+/** Whether the last passing test was of exactly this type + expression. */
+export declare function isExpressionTested(passedSignature: string | null, type: string, expression: string): boolean;
+export type ExpressionGateState = 'empty' | 'untested' | 'tested' | 'untestable';
+/**
+ * Where the expression step stands:
+ * - `empty`: nothing to test yet (blocks Next).
+ * - `untested`: needs a passing run of the current expression (blocks Next).
+ * - `tested`: the current expression passed (Next allowed).
+ * - `untestable`: the user cannot run tests, so Next is allowed with a warning.
+ */
+export declare function expressionGateState(input: {
+    type: string;
+    expression: string;
+    passedSignature: string | null;
+    canTest: boolean;
+}): ExpressionGateState;
+/** Whether the gate lets the user move past the expression step / create. */
+export declare function expressionGateAllows(state: ExpressionGateState): boolean;
+/**
+ * Whether a key press on the read-only (Reference mode) input is an attempt to
+ * edit it — printable characters, deletion, Enter. Navigation, selection and
+ * shortcuts such as Ctrl/Cmd+C stay silent.
+ */
+export declare function isEditAttemptKey(event: {
+    key: string;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    altKey?: boolean;
+}): boolean;

package/dist/bigconsole/utils/parserTestGate.js

@@ -0,0 +1,18 @@
+//#region src/bigconsole/utils/parserTestGate.ts
+function e(e, t) {
+	return `${e}\u0000${t.trim()}`;
+}
+function t(t, n, r) {
+	return t !== null && r.trim().length > 0 && t === e(n, r);
+}
+function n(e) {
+	return e.expression.trim() ? t(e.passedSignature, e.type, e.expression) ? "tested" : e.canTest ? "untested" : "untestable" : "empty";
+}
+function r(e) {
+	return e === "tested" || e === "untestable";
+}
+function i(e) {
+	return e.ctrlKey || e.metaKey || e.altKey ? !1 : e.key === "Backspace" || e.key === "Delete" || e.key === "Enter" || e.key.length === 1;
+}
+//#endregion
+export { r as expressionGateAllows, n as expressionGateState, i as isEditAttemptKey, t as isExpressionTested, e as parserTestSignature };

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.2",
+  "version": "2026.1104.4",
   "description": "BigConsole - AI-powered analytics and dashboard platform",
   "type": "module",
   "files": [