@burdenoff/fluidgrids-fe-sdk 2026.1114.5 → 2026.1114.7

package/dist/workflow-description-ReGwCZXS.js

@@ -0,0 +1,123 @@
+"use client";
+import { o as throwIfResultError } from "./errors-xPZ-IbQd.js";
+import { r as useTr } from "./TranslationBridge-Da-TPgQm.js";
+import { o as UpdateWorkflowDefinitionDocument } from "./WorkflowVersionsDocument-DRVOp8Uj.js";
+import { i as QuotaExhaustedDialog } from "./useWorkflowCodeExport-ChAzmhi6.js";
+import { jsx } from "react/jsx-runtime";
+
+// src/components/shared/CreateWorkflowRefusalDialog.tsx
+/**
+* Says why "Create Workflow" created nothing, on the page it was pressed on.
+* The builder shows it too when saving a new workflow is refused by a plan
+* quota (BOFF-9998), since that save is the create.
+*
+* - `quota-exhausted`: the plan's workflow slots are used up (G43 copy).
+* - `quota-not-provisioned`: the workspace has no plan that includes FluidGrids
+*   workflows. Nothing is used up; choosing a plan for the workspace is the way
+*   past it, so the dialog still offers View plans (round-3 verification: the
+*   refusal toast vanished and nothing pointed at billing).
+* - `failed`: no dialog. The shell's backend-error toast already shows the
+*   server's message, and nothing navigated.
+*/
+function CreateWorkflowRefusalDialog({ refusal, onClose, onUpgrade, surface }) {
+	const tr = useTr();
+	const notProvisioned = refusal?.kind === "quota-not-provisioned";
+	const open = refusal?.kind === "quota-exhausted" || refusal?.kind === "quota-not-provisioned";
+	return /* @__PURE__ */ jsx(QuotaExhaustedDialog, {
+		surface,
+		open,
+		limitHit: !notProvisioned,
+		onOpenChange: (next) => {
+			if (!next) onClose();
+		},
+		onUpgrade: () => {
+			onUpgrade();
+			onClose();
+		},
+		...notProvisioned ? {
+			title: tr("fluidgrids.components.createRefusal.notProvisionedTitle", "Workflows aren't in this workspace's plan"),
+			description: tr("fluidgrids.components.createRefusal.notProvisionedDescription", "This workspace has no plan that includes FluidGrids workflows, so no workflow was created. Choose a plan for this workspace, or ask a workspace admin to add one.")
+		} : {}
+	});
+}
+
+// src/utils/workflow-description.ts
+/** The longest description the editors accept. */
+const WORKFLOW_DESCRIPTION_MAX_LENGTH = 500;
+/**
+* Descriptions older builder saves wrote in place of a real one: every save
+* copied the workflow's name into its description, with these fallbacks for an
+* unnamed workflow. A description that only repeats the name says nothing.
+*/
+const LEGACY_PLACEHOLDERS = /* @__PURE__ */ new Set([
+	"Untitled Workflow",
+	"Workflow update",
+	"Workflow Description"
+]);
+/** The description as it is stored: surrounding whitespace removed. */
+function normalizeWorkflowDescription(text) {
+	return text.trim();
+}
+/**
+* The description worth showing for a workflow: empty when there is none, or
+* when it is a placeholder an older builder save wrote (the name again, or one
+* of the unnamed-workflow fallbacks).
+*/
+function visibleWorkflowDescription(description, name) {
+	const text = normalizeWorkflowDescription(description ?? "");
+	if (!text) return "";
+	if (text === (name ?? "").trim()) return "";
+	if (LEGACY_PLACEHOLDERS.has(text)) return "";
+	return text;
+}
+/** Decide what to do with `draft`, given the description shown before editing. */
+function commitWorkflowDescription(shown, draft) {
+	const description = normalizeWorkflowDescription(draft);
+	if (description.length > 500) return {
+		kind: "too-long",
+		length: description.length
+	};
+	if (description === normalizeWorkflowDescription(shown)) return { kind: "unchanged" };
+	return {
+		kind: "save",
+		description
+	};
+}
+/** The characters left for a draft; negative once it is too long. */
+function workflowDescriptionCharactersLeft(draft) {
+	return 500 - normalizeWorkflowDescription(draft).length;
+}
+/**
+* The `updateWorkflowDefinition` input that changes only the description. An
+* empty description is sent as "" (not null), which is what clears it.
+*/
+function workflowDescriptionUpdateInput(description, guard = {}) {
+	return {
+		description: normalizeWorkflowDescription(description),
+		...guard.expectedRevision !== void 0 ? { expectedRevision: guard.expectedRevision } : {},
+		...guard.editSessionId ? { editSessionId: guard.editSessionId } : {}
+	};
+}
+/**
+* Save `description` on the version `id`, in place. Throws the service's
+* refusal (permission, a conflict, a viewer of a shared workflow) so the
+* caller can roll its optimistic copy back and say why.
+*/
+async function saveWorkflowDescription(client, id, description, guard = {}) {
+	const { data } = throwIfResultError(await client.mutate({
+		mutation: UpdateWorkflowDefinitionDocument,
+		variables: {
+			id,
+			input: workflowDescriptionUpdateInput(description, guard)
+		}
+	}));
+	const saved = data?.updateWorkflowDefinition;
+	if (!saved) throw new Error("The description was not saved");
+	return {
+		id: saved.id,
+		description: saved.description ?? "",
+		revision: saved.revision
+	};
+}
+
+export { workflowDescriptionCharactersLeft as a, visibleWorkflowDescription as i, normalizeWorkflowDescription as n, CreateWorkflowRefusalDialog as o, saveWorkflowDescription as r, commitWorkflowDescription as t };

package/dist/workflow-pages.d.ts

@@ -1,8 +1,8 @@
 
 import { n as WorkflowsList_d_exports } from "./WorkflowsList-CcNDQge5.js";
+import { Da as VariablesPage_d_exports, Pi as ApprovalInboxPage_d_exports, QRa as InsightsPage_d_exports, Wi as TaskQueuesPage_d_exports, ZRa as InsightsPageProps, bza as AiStudioPage_d_exports, di as DataTablesPage_d_exports, eza as DataSinkDashboardPage_d_exports, ra as RunnersPage_d_exports } from "./index-D10JzNP1.js";
 import { a as WorkflowSearchRedirect_d_exports, o as WorkflowBuilder } from "./index-RWAuYE2j.js";
 import { i as TemplatePreview_d_exports, n as TemplatesPage_d_exports } from "./TemplatesPage-BG3H-6v6.js";
-import { Da as VariablesPage_d_exports, Pi as ApprovalInboxPage_d_exports, QRa as InsightsPage_d_exports, Wi as TaskQueuesPage_d_exports, ZRa as InsightsPageProps, bza as AiStudioPage_d_exports, di as DataTablesPage_d_exports, eza as DataSinkDashboardPage_d_exports, ra as RunnersPage_d_exports } from "./index-BY0V255h.js";
 import { i as ExecutionsListPage_d_exports, n as ExecutionDetailPage_d_exports } from "./ExecutionDetailPage-DvQ667OE.js";
 import { n as HistoryPage_d_exports } from "./HistoryPage-BLoRpJ1R.js";
 import { n as NodesPage_d_exports } from "./NodesPage-DEbnz9iU.js";

package/dist/workflow-pages.js

@@ -54,23 +54,23 @@ function createWorkflowPages(importers) {
 * loader, so it costs a host's first load about a kilobyte.
 */
 const pages = createWorkflowPages({
-	WorkflowsList: () => import("./WorkflowsList-4VADoiz_.js").then((n) => n.n),
-	WorkflowBuilderPage: () => import("./WorkflowBuilder-DkzzbrNn.js").then((n) => n.n).then((m) => ({ WorkflowBuilderPage: m.WorkflowBuilder })),
+	WorkflowsList: () => import("./WorkflowsList-CBqxxI44.js").then((n) => n.n),
+	WorkflowBuilderPage: () => import("./WorkflowBuilder-CdcGE0Mf.js").then((n) => n.n).then((m) => ({ WorkflowBuilderPage: m.WorkflowBuilder })),
 	WorkflowSearchRedirect: () => import("./WorkflowSearchRedirect-0MLrCjDn.js").then((n) => n.n),
-	TemplatePreview: () => import("./TemplatePreview-DwdGa8bH.js").then((n) => n.n),
-	AiStudioPage: () => import("./AiStudioPage-C2SBRqab.js").then((n) => n.n),
-	ExecutionsListPage: () => import("./ExecutionsListPage-Ky3TAL9U.js").then((n) => n.n),
-	ExecutionDetailPage: () => import("./ExecutionDetailPage-heD4wBjg.js").then((n) => n.n),
+	TemplatePreview: () => import("./TemplatePreview-Bi6LSeH8.js").then((n) => n.n),
+	AiStudioPage: () => import("./AiStudioPage-DLl4ld32.js").then((n) => n.n),
+	ExecutionsListPage: () => import("./ExecutionsListPage-CMrOaFKQ.js").then((n) => n.n),
+	ExecutionDetailPage: () => import("./ExecutionDetailPage-DxeySgR3.js").then((n) => n.n),
 	HistoryPage: () => import("./HistoryPage-D4rkw4zu.js").then((n) => n.n),
-	TemplatesPage: () => import("./TemplatesPage-DF5PK7CB.js").then((n) => n.n),
+	TemplatesPage: () => import("./TemplatesPage-D9fOKAn4.js").then((n) => n.n),
 	NodesPage: () => import("./NodesPage-C3sh0aL9.js").then((n) => n.n),
-	SettingsPage: () => import("./SettingsPage-BSucNHrq.js").then((n) => n.n),
+	SettingsPage: () => import("./SettingsPage-DwA2ZjyH.js").then((n) => n.n),
 	InsightsPage: () => import("./InsightsPage-CVzNu4F7.js").then((n) => n.r),
 	ErrorAnalyticsPage: () => import("./InsightsPage-CVzNu4F7.js").then((n) => n.r),
 	DataSinkDashboardPage: () => import("./DataSinkDashboardPage-Dnp1yRYQ.js").then((n) => n.n),
 	VariablesPage: () => import("./VariablesPage-Bx3LNar7.js").then((n) => n.n),
 	RunnersPage: () => import("./RunnersPage-D2teM_sE.js").then((n) => n.n),
-	TaskQueuesPage: () => import("./TaskQueuesPage-WMJz9imi.js").then((n) => n.r),
+	TaskQueuesPage: () => import("./TaskQueuesPage-BuWQwT5I.js").then((n) => n.r),
 	ApprovalInboxPage: () => import("./ApprovalInboxPage-CM2nA4eE.js").then((n) => n.n),
 	DataTablesPage: () => import("./DataTablesPage-C7I_PCvD.js").then((n) => n.n)
 });

package/dist/{workflow-code-transfer-BsLPUrKP.js → workflow-transfer-CktP7o1c.js}

@@ -320,4 +320,106 @@ function lineOfNode(source, nodeId) {
 	return null;
 }
 
-export { sortFidelityItems as _, assertImportByteSize as a, utf8Length as b, fileBaseName as c, isLosslessReport as d, isLossyFidelityItem as f, readProjectArchive as g, primaryImportModule as h, MAX_IMPORT_SOURCE_BYTES as i, importAcceptAttribute as l, orderedExportFiles as m, ImportSourceError as n, buildExportDownload as o, lineOfNode as p, MAX_IMPORT_ARCHIVE_BYTES as r, checkTypeScriptImport as s, CODE_EXPORT_FORMATS as t, importFileKind as u, typeScriptImportSource as v, workflowNameFromFile as x, typeScriptModuleFile as y };
+// src/utils/workflow-transfer.ts
+function asRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
+function collectWorkflowNodeReferences(definition) {
+	const nodes = asRecord(asRecord(definition)?.data)?.nodes;
+	if (!Array.isArray(nodes)) return [];
+	const seen = /* @__PURE__ */ new Set();
+	const references = [];
+	for (const candidate of nodes) {
+		const node = asRecord(candidate);
+		const nodeData = asRecord(node?.data);
+		const nodeId = typeof node?.id === "string" ? node.id : null;
+		const nodeType = typeof nodeData?.nodeId === "string" ? nodeData.nodeId : node?.type;
+		if (!nodeId || typeof nodeType !== "string") continue;
+		const nodeVersion = typeof nodeData?.nodeVersion === "string" ? nodeData.nodeVersion : null;
+		const key = `${nodeId}:${nodeType}:${nodeVersion ?? ""}`;
+		if (seen.has(key)) continue;
+		seen.add(key);
+		references.push({
+			nodeId,
+			nodeType,
+			nodeVersion
+		});
+	}
+	return references;
+}
+function createWorkflowExportPayload(workflow) {
+	const definitionJson = asRecord(workflow.definitionJson);
+	if (!definitionJson) throw new Error("Workflow definition JSON must be an object");
+	return {
+		format: "fluidgrids.workflow",
+		schemaVersion: 1,
+		exportedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		workflowKey: workflow.workflowKey,
+		version: workflow.version,
+		name: workflow.name,
+		description: workflow.description ?? null,
+		definitionJson,
+		context: asRecord(workflow.context),
+		tags: workflow.tags,
+		tagsV2: workflow.tagsV2,
+		icon: workflow.icon ?? null,
+		category: workflow.category ?? null,
+		nodeReferences: collectWorkflowNodeReferences(definitionJson)
+	};
+}
+/** Saves a blob through a temporary object URL and anchor click. */
+function downloadBlob(filename, blob) {
+	const url = URL.createObjectURL(blob);
+	const anchor = document.createElement("a");
+	anchor.href = url;
+	anchor.download = filename;
+	anchor.click();
+	URL.revokeObjectURL(url);
+}
+function downloadWorkflowExport(workflow) {
+	const payload = createWorkflowExportPayload(workflow);
+	const blob = new Blob([JSON.stringify(payload, null, 2)], { type: "application/json" });
+	downloadBlob(`${workflow.workflowKey}-${workflow.version}.fluidgrids.json`, blob);
+}
+function isN8nNodeType(type) {
+	return typeof type === "string" && (type.startsWith("n8n-nodes-") || type.startsWith("@n8n/"));
+}
+/**
+* Whether a JSON document is an n8n workflow export (as exported, or copied
+* from the n8n canvas): a `nodes` list of named n8n nodes and a
+* `connections` object. The service applies the same test (BOFF-9730).
+*/
+function isN8nWorkflowJson(value) {
+	const root = asRecord(value);
+	if (!root || !Array.isArray(root.nodes) || root.nodes.length === 0) return false;
+	if (root.connections !== void 0 && !asRecord(root.connections)) return false;
+	const nodes = root.nodes.map(asRecord);
+	return nodes.every((node) => node !== null && typeof node.name === "string" && typeof node.type === "string" && node.type.length > 0) && nodes.some((node) => isN8nNodeType(node?.type));
+}
+function parseWorkflowImport(raw) {
+	const root = asRecord(JSON.parse(raw));
+	if (!root) throw new Error("Import must contain a JSON object");
+	if (isN8nWorkflowJson(root)) return {
+		source: "n8n",
+		definitionJson: root,
+		name: typeof root.name === "string" && root.name.trim() ? root.name.trim() : "Imported n8n workflow",
+		nodeReferences: []
+	};
+	const definitionJson = asRecord(root.definitionJson) ?? root;
+	return {
+		source: "fluidgrids",
+		definitionJson,
+		name: typeof root.name === "string" && root.name.trim() ? root.name : "Imported workflow",
+		workflowKey: typeof root.workflowKey === "string" ? root.workflowKey : void 0,
+		version: typeof root.version === "string" ? root.version : void 0,
+		description: typeof root.description === "string" ? root.description : void 0,
+		context: asRecord(root.context) ?? void 0,
+		tags: Array.isArray(root.tags) && root.tags.every((tag) => typeof tag === "string") ? root.tags : void 0,
+		tagsV2: root.tagsV2,
+		icon: typeof root.icon === "string" ? root.icon : void 0,
+		category: typeof root.category === "string" ? root.category : void 0,
+		nodeReferences: Array.isArray(root.nodeReferences) ? root.nodeReferences : collectWorkflowNodeReferences(definitionJson)
+	};
+}
+
+export { utf8Length as C, typeScriptModuleFile as S, orderedExportFiles as _, ImportSourceError as a, sortFidelityItems as b, assertImportByteSize as c, fileBaseName as d, importAcceptAttribute as f, lineOfNode as g, isLossyFidelityItem as h, CODE_EXPORT_FORMATS as i, buildExportDownload as l, isLosslessReport as m, downloadWorkflowExport as n, MAX_IMPORT_ARCHIVE_BYTES as o, importFileKind as p, parseWorkflowImport as r, MAX_IMPORT_SOURCE_BYTES as s, downloadBlob as t, checkTypeScriptImport as u, primaryImportModule as v, workflowNameFromFile as w, typeScriptImportSource as x, readProjectArchive as y };

package/dist/workflows-list.js

@@ -1,5 +1,5 @@
 "use client";
-import { t as WorkflowsList } from "./WorkflowsList-4VADoiz_.js";
+import { t as WorkflowsList } from "./WorkflowsList-CBqxxI44.js";
 import { n as ACTION_PARAM_VALUES, t as ACTION_PARAM } from "./useActionParam-B0ebTZmg.js";
 
 export { ACTION_PARAM, ACTION_PARAM_VALUES, WorkflowsList };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/fluidgrids-fe-sdk",
-  "version": "2026.1114.5",
+  "version": "2026.1114.7",
   "description": "FluidGrids Workflow Builder SDK - Embeddable visual workflow automation",
   "type": "module",
   "imports": {

package/dist/QuotaExhaustedDialog-YjKgRTmu.js

@@ -1,55 +0,0 @@
-"use client";
-import { r as useTr } from "./TranslationBridge-Da-TPgQm.js";
-import { un as useFluidGridsAnalytics } from "./FluidGridsProvider-C-WGQwuT.js";
-import { c as emitWorkflowLimitHit, o as emitUpgradeClicked } from "./fluidgridsEvents-Dm5CaHtr.js";
-import { i as WORKFLOWS_QUOTA_NAME } from "./quota-Cdt8yz7N.js";
-import { useEffect, useRef } from "react";
-import { jsx, jsxs } from "react/jsx-runtime";
-import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle } from "@burdenoff/fe-libs/ui";
-
-// src/components/shared/QuotaExhaustedDialog.tsx
-/**
-* Alert shown when a workflow-creating action (save/duplicate/import) is
-* rejected with `QUOTA_EXHAUSTED` for `fluidgrids.workflows.count`. Mirrors
-* the "Folder Limit Reached" dialog in microfe-files' BrowserPage.tsx, built
-* on the same `AlertDialog` primitives already used elsewhere in this SDK
-* (see card-workflow.tsx's delete-confirmation dialog).
-*/
-function QuotaExhaustedDialog({ open, onOpenChange, onUpgrade, title, description, surface, limitHit = true }) {
-	const tr = useTr();
-	const { bus, workspaceId } = useFluidGridsAnalytics();
-	const wasOpen = useRef(false);
-	useEffect(() => {
-		if (open && !wasOpen.current && limitHit) emitWorkflowLimitHit(bus, {
-			workspaceId,
-			surface
-		});
-		wasOpen.current = open;
-	}, [
-		open,
-		bus,
-		workspaceId,
-		surface,
-		limitHit
-	]);
-	const handleUpgrade = () => {
-		emitUpgradeClicked(bus, {
-			workspaceId,
-			surface: "quota-dialog",
-			quotaKey: WORKFLOWS_QUOTA_NAME
-		});
-		onUpgrade();
-	};
-	const resolvedTitle = title ?? tr("fluidgrids.components.quotaExhaustedDialog.title", "Workflow Limit Reached");
-	const resolvedDescription = description ?? tr("fluidgrids.components.quotaExhaustedDialog.description", "You've reached the workflow limit for your plan. Upgrade your plan to create more workflows.");
-	return /* @__PURE__ */ jsx(AlertDialog, {
-		open,
-		onOpenChange,
-		children: /* @__PURE__ */ jsxs(AlertDialogContent, { children: [/* @__PURE__ */ jsxs(AlertDialogHeader, { children: [/* @__PURE__ */ jsx(AlertDialogTitle, { children: resolvedTitle }), /* @__PURE__ */ jsx(AlertDialogDescription, { children: resolvedDescription })] }), /* @__PURE__ */ jsxs(AlertDialogFooter, { children: [/* @__PURE__ */ jsx(AlertDialogCancel, { children: tr("fluidgrids.components.quotaExhaustedDialog.dismiss", "Dismiss") }), /* @__PURE__ */ jsx(AlertDialogAction, {
-			onClick: handleUpgrade,
-			children: tr("fluidgrids.components.quotaExhaustedDialog.viewPlans", "View plans")
-		})] })] })
-	});
-}
-
-export { QuotaExhaustedDialog as t };