@notmrabhi/flowforge 0.1.34 → 0.1.36

package/README.md

@@ -46,6 +46,58 @@ export function Builder() {
 }
 ```
 
+## Loading templates from a backend
+
+Instead of hardcoding `templateRegistry.register({...})` calls, fetch templates
+from your API and bulk-register them. The package accepts the backend wire
+shape directly via `registerFromApi`:
+
+```ts
+import { templateRegistry } from '@miniorange/flowforge/templates';
+import type { ApiWorkflowTemplate } from '@miniorange/flowforge/canvas';
+
+async function loadTemplates() {
+  const res  = await fetch('/api/v1/workflow-template');
+  const list: ApiWorkflowTemplate[] = await res.json();
+  templateRegistry.clear().registerFromApi(list);
+}
+```
+
+Expected payload shape per row (the backend's persistence model + a `templateUI`
+JSON column for UI fields):
+
+```jsonc
+{
+  "key": "END_USER_CREATION",
+  "name": "New User Registration",
+  "description": "…",
+  "state": "PUBLISHED",
+  "allowedTasks":  ["USER_CREATION", "USER_GROUP_ASSIGNMENT", "USER_ROLE_ASSIGNMENT"],
+  "allowedSources": ["SIGNUP_FLOW", "ADMIN_CREATION_FLOW"],
+  "configuration":  { /* runtime BPMN — ignored by the canvas */ },
+  "templateUI": {
+    "triggerCategory": "event",
+    "icon": "user-plus",
+    "tags": ["onboarding"],
+    "category": "User Lifecycle",
+    "author": "miniOrange",
+    "popularity": 100,
+    "source": "system",
+    "product": "IAM",
+    "maxTasks": 10,
+    "taskLabels": { "USER_GROUP_ASSIGNMENT": "Assign Groups" },
+    "skeletonState": {
+      "slots": [ /* CanvasSlot[] — pre-seeded canvas chain */ ],
+      "branches": {}
+    }
+  }
+}
+```
+
+`registerFromApi` normalises `allowedTasks → availableTasks` automatically.
+Bad rows (missing `key`) are skipped with a DEV-mode warning, so a single
+malformed template doesn't blank the picker.
+
 ## Entry points
 
 | Import | Contents |

package/dist/{SchemaBuilderDrawer-BbkOK4Xc.js → SchemaBuilderDrawer-CUzYWGCN.js}

@@ -1,6 +1,6 @@
 import { useMemo as P, useState as T, useRef as M, useEffect as de, useCallback as te } from "react";
 import { useFormik as ke } from "formik";
-import { k as pe, C as Ne, g as oe, a as ue, b as ie, v as se, E as ze, d as Te, V as we } from "./index-CEg1wTCw.js";
+import { k as pe, C as Ne, g as oe, a as ue, b as ie, v as se, E as ze, d as Te, V as we } from "./index-B74jTc2b.js";
 import { jsxs as t, Fragment as q, jsx as e } from "react/jsx-runtime";
 import { Box as n, Collapse as Ie, Tooltip as A, Dialog as he, Typography as S, IconButton as Y, Stepper as Fe, Step as Oe, StepLabel as Re, Drawer as Ee, Chip as We, Divider as Ae } from "@mui/material";
 import { MdCheck as G, MdClose as _, MdAdd as J, MdArrowBack as fe, MdEdit as De, MdDeleteOutline as Pe, MdSettings as be, MdArrowForward as Me } from "react-icons/md";
@@ -1134,4 +1134,4 @@ export {
   cl as a,
   sl as u
 };
-//# sourceMappingURL=SchemaBuilderDrawer-BbkOK4Xc.js.map
+//# sourceMappingURL=SchemaBuilderDrawer-CUzYWGCN.js.map