@notmrabhi/flowforge 0.1.35 → 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/canvas.d.ts

@@ -24,6 +24,38 @@ export declare interface AddStepContext {
     branch?: string;
 }
 
+/**
+ * Wire shape the backend `/api/v1/workflow-template` endpoint is expected
+ * to return. Top-level fields mirror the persistence model; everything
+ * UI-related lives under `templateUI`. Use with `templateRegistry.registerFromApi(list)`.
+ */
+export declare interface ApiWorkflowTemplate {
+    key: string;
+    name: string;
+    state?: string;
+    description?: string;
+    allowedTasks?: string[];
+    allowedSources?: string[];
+    configuration?: Record<string, unknown>;
+    templateUI?: Partial<Omit<WorkflowTemplate, 'triggerKey' | 'label' | 'description' | 'availableTasks'>>;
+}
+
+/**
+ * Wire shape the backend `/api/v1/workflow-template` endpoint is expected
+ * to return. Top-level fields mirror the persistence model; everything
+ * UI-related lives under `templateUI`. Use with `templateRegistry.registerFromApi(list)`.
+ */
+declare interface ApiWorkflowTemplate_2 {
+    key: string;
+    name: string;
+    state?: string;
+    description?: string;
+    allowedTasks?: string[];
+    allowedSources?: string[];
+    configuration?: Record<string, unknown>;
+    templateUI?: Partial<Omit<WorkflowTemplate_3, 'triggerKey' | 'label' | 'description' | 'availableTasks'>>;
+}
+
 export declare const ApprovalNode: ({ id, data }: NodeProps) => JSX_2.Element;
 
 export declare interface BpmnElement {
@@ -727,13 +759,40 @@ declare interface SubWorkflowPreviewDrawerProps {
 
 declare class TemplateRegistry {
     private templates;
+    /**
+     * Register a template. Normalises `allowedTasks` (the backend's name) →
+     * `availableTasks` (FlowForge's canonical name) so consumers can pass
+     * either without rewriting.
+     */
     register(template: WorkflowTemplate_3): this;
+    /**
+     * Register a list of templates fetched from `GET /api/v1/workflow-template`.
+     *
+     * The API shape is:
+     *   {
+     *     key, name, description, allowedTasks, allowedSources,
+     *     configuration,            // runtime BPMN — ignored by the canvas
+     *     templateUI: {             // ← UI bag, spread onto the template
+     *       triggerCategory, icon, tags, category, author, popularity,
+     *       source, product, taskLabels, maxTasks, skeletonState, …
+     *     }
+     *   }
+     *
+     * Anything in `templateUI` overrides the top-level shorthand where there's
+     * an overlap. Bad rows (missing `key`) are skipped with a DEV warning
+     * rather than throwing, so one broken template doesn't blank the picker.
+     *
+     * Returns `this` for chaining and the count of templates registered.
+     */
+    registerFromApi(list: ApiWorkflowTemplate_2[]): this;
     lookup(triggerKey: string): WorkflowTemplate_3 | undefined;
     list(): WorkflowTemplate_3[];
     listByCategory(category: string): WorkflowTemplate_3[];
     listByTag(tag: string): WorkflowTemplate_3[];
     search(query: string): WorkflowTemplate_3[];
     categories(): string[];
+    /** Remove every template — useful before re-loading from backend. */
+    clear(): this;
 }
 
 export declare const TriggerNode: ({ data }: NodeProps) => JSX_2.Element;
@@ -776,7 +835,13 @@ export declare interface WorkflowTemplate {
     description?: string;
     icon?: ReactNode;
     triggerCategory?: 'event' | 'scheduler' | 'webhook' | string;
+    /**
+     * Task IDs (descriptor types) that can be inserted into this workflow.
+     * `allowedTasks` is accepted as an alias for backend payloads that use
+     * that name — TemplateRegistry.register() normalises them.
+     */
     availableTasks?: string[];
+    allowedTasks?: string[];
     maxTasks?: number;
     taskLabels?: Record<string, string>;
     fixedNodes?: FixedNode_3[];
@@ -802,7 +867,13 @@ declare interface WorkflowTemplate_2 {
     description?: string;
     icon?: ReactNode;
     triggerCategory?: 'event' | 'scheduler' | 'webhook' | string;
+    /**
+     * Task IDs (descriptor types) that can be inserted into this workflow.
+     * `allowedTasks` is accepted as an alias for backend payloads that use
+     * that name — TemplateRegistry.register() normalises them.
+     */
     availableTasks?: string[];
+    allowedTasks?: string[];
     maxTasks?: number;
     taskLabels?: Record<string, string>;
     fixedNodes?: FixedNode[];
@@ -828,7 +899,13 @@ declare interface WorkflowTemplate_3 {
     description?: string;
     icon?: ReactNode;
     triggerCategory?: 'event' | 'scheduler' | 'webhook' | string;
+    /**
+     * Task IDs (descriptor types) that can be inserted into this workflow.
+     * `allowedTasks` is accepted as an alias for backend payloads that use
+     * that name — TemplateRegistry.register() normalises them.
+     */
     availableTasks?: string[];
+    allowedTasks?: string[];
     maxTasks?: number;
     taskLabels?: Record<string, string>;
     fixedNodes?: FixedNode_2[];

package/dist/core.d.ts

@@ -1,6 +1,22 @@
 import { AnySchema } from 'yup';
 import { ReactNode } from 'react';
 
+/**
+ * Wire shape the backend `/api/v1/workflow-template` endpoint is expected
+ * to return. Top-level fields mirror the persistence model; everything
+ * UI-related lives under `templateUI`. Use with `templateRegistry.registerFromApi(list)`.
+ */
+export declare interface ApiWorkflowTemplate {
+    key: string;
+    name: string;
+    state?: string;
+    description?: string;
+    allowedTasks?: string[];
+    allowedSources?: string[];
+    configuration?: Record<string, unknown>;
+    templateUI?: Partial<Omit<WorkflowTemplate, 'triggerKey' | 'label' | 'description' | 'availableTasks'>>;
+}
+
 /**
  * Base defaults shared by every node descriptor. A new node only has to specify
  * what makes it different — these fill in the rest.
@@ -350,13 +366,40 @@ export declare interface SubWorkflowDescriptorOptions {
 
 export declare class TemplateRegistry {
     private templates;
+    /**
+     * Register a template. Normalises `allowedTasks` (the backend's name) →
+     * `availableTasks` (FlowForge's canonical name) so consumers can pass
+     * either without rewriting.
+     */
     register(template: WorkflowTemplate): this;
+    /**
+     * Register a list of templates fetched from `GET /api/v1/workflow-template`.
+     *
+     * The API shape is:
+     *   {
+     *     key, name, description, allowedTasks, allowedSources,
+     *     configuration,            // runtime BPMN — ignored by the canvas
+     *     templateUI: {             // ← UI bag, spread onto the template
+     *       triggerCategory, icon, tags, category, author, popularity,
+     *       source, product, taskLabels, maxTasks, skeletonState, …
+     *     }
+     *   }
+     *
+     * Anything in `templateUI` overrides the top-level shorthand where there's
+     * an overlap. Bad rows (missing `key`) are skipped with a DEV warning
+     * rather than throwing, so one broken template doesn't blank the picker.
+     *
+     * Returns `this` for chaining and the count of templates registered.
+     */
+    registerFromApi(list: ApiWorkflowTemplate[]): this;
     lookup(triggerKey: string): WorkflowTemplate | undefined;
     list(): WorkflowTemplate[];
     listByCategory(category: string): WorkflowTemplate[];
     listByTag(tag: string): WorkflowTemplate[];
     search(query: string): WorkflowTemplate[];
     categories(): string[];
+    /** Remove every template — useful before re-loading from backend. */
+    clear(): this;
 }
 
 export declare const templateRegistry: TemplateRegistry;
@@ -376,7 +419,13 @@ export declare interface WorkflowTemplate {
     description?: string;
     icon?: ReactNode;
     triggerCategory?: 'event' | 'scheduler' | 'webhook' | string;
+    /**
+     * Task IDs (descriptor types) that can be inserted into this workflow.
+     * `allowedTasks` is accepted as an alias for backend payloads that use
+     * that name — TemplateRegistry.register() normalises them.
+     */
     availableTasks?: string[];
+    allowedTasks?: string[];
     maxTasks?: number;
     taskLabels?: Record<string, string>;
     fixedNodes?: FixedNode[];

package/dist/index.d.ts

@@ -41,6 +41,22 @@ export declare interface AddStepContext {
     branch?: string;
 }
 
+/**
+ * Wire shape the backend `/api/v1/workflow-template` endpoint is expected
+ * to return. Top-level fields mirror the persistence model; everything
+ * UI-related lives under `templateUI`. Use with `templateRegistry.registerFromApi(list)`.
+ */
+export declare interface ApiWorkflowTemplate {
+    key: string;
+    name: string;
+    state?: string;
+    description?: string;
+    allowedTasks?: string[];
+    allowedSources?: string[];
+    configuration?: Record<string, unknown>;
+    templateUI?: Partial<Omit<WorkflowTemplate, 'triggerKey' | 'label' | 'description' | 'availableTasks'>>;
+}
+
 export declare const ApprovalNode: ({ id, data }: NodeProps) => JSX_2.Element;
 
 /** True if the AST contains at least one non-text node. */
@@ -1290,13 +1306,40 @@ export declare interface TabsFieldDescriptor extends FieldDescriptor {
 
 export declare class TemplateRegistry {
     private templates;
+    /**
+     * Register a template. Normalises `allowedTasks` (the backend's name) →
+     * `availableTasks` (FlowForge's canonical name) so consumers can pass
+     * either without rewriting.
+     */
     register(template: WorkflowTemplate): this;
+    /**
+     * Register a list of templates fetched from `GET /api/v1/workflow-template`.
+     *
+     * The API shape is:
+     *   {
+     *     key, name, description, allowedTasks, allowedSources,
+     *     configuration,            // runtime BPMN — ignored by the canvas
+     *     templateUI: {             // ← UI bag, spread onto the template
+     *       triggerCategory, icon, tags, category, author, popularity,
+     *       source, product, taskLabels, maxTasks, skeletonState, …
+     *     }
+     *   }
+     *
+     * Anything in `templateUI` overrides the top-level shorthand where there's
+     * an overlap. Bad rows (missing `key`) are skipped with a DEV warning
+     * rather than throwing, so one broken template doesn't blank the picker.
+     *
+     * Returns `this` for chaining and the count of templates registered.
+     */
+    registerFromApi(list: ApiWorkflowTemplate[]): this;
     lookup(triggerKey: string): WorkflowTemplate | undefined;
     list(): WorkflowTemplate[];
     listByCategory(category: string): WorkflowTemplate[];
     listByTag(tag: string): WorkflowTemplate[];
     search(query: string): WorkflowTemplate[];
     categories(): string[];
+    /** Remove every template — useful before re-loading from backend. */
+    clear(): this;
 }
 
 export declare const templateRegistry: TemplateRegistry;
@@ -1468,7 +1511,13 @@ export declare interface WorkflowTemplate {
     description?: string;
     icon?: ReactNode;
     triggerCategory?: 'event' | 'scheduler' | 'webhook' | string;
+    /**
+     * Task IDs (descriptor types) that can be inserted into this workflow.
+     * `allowedTasks` is accepted as an alias for backend payloads that use
+     * that name — TemplateRegistry.register() normalises them.
+     */
     availableTasks?: string[];
+    allowedTasks?: string[];
     maxTasks?: number;
     taskLabels?: Record<string, string>;
     fixedNodes?: FixedNode[];

package/dist/nodeRegistry.d.ts

@@ -336,7 +336,13 @@ declare interface WorkflowTemplate {
     description?: string;
     icon?: ReactNode;
     triggerCategory?: 'event' | 'scheduler' | 'webhook' | string;
+    /**
+     * Task IDs (descriptor types) that can be inserted into this workflow.
+     * `allowedTasks` is accepted as an alias for backend payloads that use
+     * that name — TemplateRegistry.register() normalises them.
+     */
     availableTasks?: string[];
+    allowedTasks?: string[];
     maxTasks?: number;
     taskLabels?: Record<string, string>;
     fixedNodes?: FixedNode[];

package/dist/templateRegistry.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class o{constructor(){this.templates=new Map}register(e){return this.templates.set(e.triggerKey,e),this}lookup(e){return this.templates.get(e)}list(){return[...this.templates.values()]}listByCategory(e){return this.list().filter(t=>t.category===e)}listByTag(e){return this.list().filter(t=>{var s;return(s=t.tags)==null?void 0:s.includes(e)})}search(e){const t=e.toLowerCase();return this.list().filter(s=>{var r,i,a;return s.label.toLowerCase().includes(t)||((r=s.description)==null?void 0:r.toLowerCase().includes(t))||((i=s.tags)==null?void 0:i.some(l=>l.toLowerCase().includes(t)))||((a=s.category)==null?void 0:a.toLowerCase().includes(t))})}categories(){const e=new Set;return this.list().forEach(t=>{t.category&&e.add(t.category)}),Array.from(e)}}const c=new o;exports.TemplateRegistry=o;exports.templateRegistry=c;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class l{constructor(){this.templates=new Map}register(t){const e={...t,availableTasks:t.availableTasks??t.allowedTasks};return this.templates.set(e.triggerKey,e),this}registerFromApi(t){for(const e of t??[])e!=null&&e.key&&this.register({triggerKey:e.key,label:e.name??e.key,description:e.description,availableTasks:e.allowedTasks,...e.templateUI??{}});return this}lookup(t){return this.templates.get(t)}list(){return[...this.templates.values()]}listByCategory(t){return this.list().filter(e=>e.category===t)}listByTag(t){return this.list().filter(e=>{var s;return(s=e.tags)==null?void 0:s.includes(t)})}search(t){const e=t.toLowerCase();return this.list().filter(s=>{var r,i,a;return s.label.toLowerCase().includes(e)||((r=s.description)==null?void 0:r.toLowerCase().includes(e))||((i=s.tags)==null?void 0:i.some(o=>o.toLowerCase().includes(e)))||((a=s.category)==null?void 0:a.toLowerCase().includes(e))})}categories(){const t=new Set;return this.list().forEach(e=>{e.category&&t.add(e.category)}),Array.from(t)}clear(){return this.templates.clear(),this}}const n=new l;exports.TemplateRegistry=l;exports.templateRegistry=n;
 //# sourceMappingURL=templateRegistry.cjs.map

package/dist/templateRegistry.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"templateRegistry.cjs","sources":["../src/templateRegistry/index.ts"],"sourcesContent":["import { WorkflowTemplate } from '../WorkflowCanvas/types';\r\n\r\nexport class TemplateRegistry {\r\n  private templates = new Map<string, WorkflowTemplate>();\r\n\r\n  register(template: WorkflowTemplate): this {\r\n    this.templates.set(template.triggerKey, template);\r\n    return this;\r\n  }\r\n\r\n  lookup(triggerKey: string): WorkflowTemplate | undefined {\r\n    return this.templates.get(triggerKey);\r\n  }\r\n\r\n  list(): WorkflowTemplate[] {\r\n    return [...this.templates.values()];\r\n  }\r\n\r\n  listByCategory(category: string): WorkflowTemplate[] {\r\n    return this.list().filter((t) => t.category === category);\r\n  }\r\n\r\n  listByTag(tag: string): WorkflowTemplate[] {\r\n    return this.list().filter((t) => t.tags?.includes(tag));\r\n  }\r\n\r\n  search(query: string): WorkflowTemplate[] {\r\n    const q = query.toLowerCase();\r\n    return this.list().filter(\r\n      (t) =>\r\n        t.label.toLowerCase().includes(q) ||\r\n        t.description?.toLowerCase().includes(q) ||\r\n        t.tags?.some((tag) => tag.toLowerCase().includes(q)) ||\r\n        t.category?.toLowerCase().includes(q),\r\n    );\r\n  }\r\n\r\n  categories(): string[] {\r\n    const cats = new Set<string>();\r\n    this.list().forEach((t) => { if (t.category) cats.add(t.category); });\r\n    return Array.from(cats);\r\n  }\r\n}\r\n\r\nexport const templateRegistry = new TemplateRegistry();\r\nexport type { WorkflowTemplate };\r\n"],"names":["TemplateRegistry","template","triggerKey","category","tag","_a","query","q","t","_b","_c","cats","templateRegistry"],"mappings":"gFAEO,MAAMA,CAAiB,CAAvB,aAAA,CACL,KAAQ,cAAgB,GAA8B,CAEtD,SAASC,EAAkC,CACzC,YAAK,UAAU,IAAIA,EAAS,WAAYA,CAAQ,EACzC,IACT,CAEA,OAAOC,EAAkD,CACvD,OAAO,KAAK,UAAU,IAAIA,CAAU,CACtC,CAEA,MAA2B,CACzB,MAAO,CAAC,GAAG,KAAK,UAAU,QAAQ,CACpC,CAEA,eAAeC,EAAsC,CACnD,OAAO,KAAK,OAAO,OAAQ,GAAM,EAAE,WAAaA,CAAQ,CAC1D,CAEA,UAAUC,EAAiC,CACzC,OAAO,KAAK,KAAA,EAAO,OAAQ,UAAM,OAAAC,EAAA,EAAE,OAAF,YAAAA,EAAQ,SAASD,GAAI,CACxD,CAEA,OAAOE,EAAmC,CACxC,MAAMC,EAAID,EAAM,YAAA,EAChB,OAAO,KAAK,OAAO,OAChBE,GAAA,WACC,OAAAA,EAAE,MAAM,cAAc,SAASD,CAAC,KAChCF,EAAAG,EAAE,cAAF,YAAAH,EAAe,cAAc,SAASE,OACtCE,EAAAD,EAAE,OAAF,YAAAC,EAAQ,KAAML,GAAQA,EAAI,cAAc,SAASG,CAAC,OAClDG,EAAAF,EAAE,WAAF,YAAAE,EAAY,cAAc,SAASH,IAAC,CAE1C,CAEA,YAAuB,CACrB,MAAMI,MAAW,IACjB,YAAK,KAAA,EAAO,QAAS,GAAM,CAAM,EAAE,UAAUA,EAAK,IAAI,EAAE,QAAQ,CAAG,CAAC,EAC7D,MAAM,KAAKA,CAAI,CACxB,CACF,CAEO,MAAMC,EAAmB,IAAIZ"}
+{"version":3,"file":"templateRegistry.cjs","sources":["../src/templateRegistry/index.ts"],"sourcesContent":["import type { WorkflowTemplate, ApiWorkflowTemplate } from '../WorkflowCanvas/types';\n\nexport class TemplateRegistry {\n  private templates = new Map<string, WorkflowTemplate>();\n\n  /**\n   * Register a template. Normalises `allowedTasks` (the backend's name) →\n   * `availableTasks` (FlowForge's canonical name) so consumers can pass\n   * either without rewriting.\n   */\n  register(template: WorkflowTemplate): this {\n    const normalised: WorkflowTemplate = {\n      ...template,\n      availableTasks: template.availableTasks ?? template.allowedTasks,\n    };\n    this.templates.set(normalised.triggerKey, normalised);\n    return this;\n  }\n\n  /**\n   * Register a list of templates fetched from `GET /api/v1/workflow-template`.\n   *\n   * The API shape is:\n   *   {\n   *     key, name, description, allowedTasks, allowedSources,\n   *     configuration,            // runtime BPMN — ignored by the canvas\n   *     templateUI: {             // ← UI bag, spread onto the template\n   *       triggerCategory, icon, tags, category, author, popularity,\n   *       source, product, taskLabels, maxTasks, skeletonState, …\n   *     }\n   *   }\n   *\n   * Anything in `templateUI` overrides the top-level shorthand where there's\n   * an overlap. Bad rows (missing `key`) are skipped with a DEV warning\n   * rather than throwing, so one broken template doesn't blank the picker.\n   *\n   * Returns `this` for chaining and the count of templates registered.\n   */\n  registerFromApi(list: ApiWorkflowTemplate[]): this {\n    for (const t of list ?? []) {\n      if (!t?.key) {\n        if (import.meta.env?.DEV) {\n          // eslint-disable-next-line no-console\n          console.warn('[FlowForge] templateRegistry.registerFromApi: skipped row without `key`', t);\n        }\n        continue;\n      }\n      this.register({\n        triggerKey: t.key,\n        label: t.name ?? t.key,\n        description: t.description,\n        availableTasks: t.allowedTasks,\n        ...(t.templateUI ?? {}),\n      } as WorkflowTemplate);\n    }\n    return this;\n  }\n\n  lookup(triggerKey: string): WorkflowTemplate | undefined {\n    return this.templates.get(triggerKey);\n  }\n\n  list(): WorkflowTemplate[] {\n    return [...this.templates.values()];\n  }\n\n  listByCategory(category: string): WorkflowTemplate[] {\n    return this.list().filter((t) => t.category === category);\n  }\n\n  listByTag(tag: string): WorkflowTemplate[] {\n    return this.list().filter((t) => t.tags?.includes(tag));\n  }\n\n  search(query: string): WorkflowTemplate[] {\n    const q = query.toLowerCase();\n    return this.list().filter(\n      (t) =>\n        t.label.toLowerCase().includes(q) ||\n        t.description?.toLowerCase().includes(q) ||\n        t.tags?.some((tag) => tag.toLowerCase().includes(q)) ||\n        t.category?.toLowerCase().includes(q),\n    );\n  }\n\n  categories(): string[] {\n    const cats = new Set<string>();\n    this.list().forEach((t) => { if (t.category) cats.add(t.category); });\n    return Array.from(cats);\n  }\n\n  /** Remove every template — useful before re-loading from backend. */\n  clear(): this {\n    this.templates.clear();\n    return this;\n  }\n}\n\nexport const templateRegistry = new TemplateRegistry();\nexport type { WorkflowTemplate, ApiWorkflowTemplate };\n"],"names":["TemplateRegistry","template","normalised","list","t","triggerKey","category","tag","_a","query","q","_b","_c","cats","templateRegistry"],"mappings":"gFAEO,MAAMA,CAAiB,CAAvB,aAAA,CACL,KAAQ,cAAgB,GAA8B,CAOtD,SAASC,EAAkC,CACzC,MAAMC,EAA+B,CACnC,GAAGD,EACH,eAAgBA,EAAS,gBAAkBA,EAAS,YAAA,EAEtD,YAAK,UAAU,IAAIC,EAAW,WAAYA,CAAU,EAC7C,IACT,CAqBA,gBAAgBC,EAAmC,CACjD,UAAWC,KAAKD,GAAQ,GACjBC,GAAA,MAAAA,EAAG,KAOR,KAAK,SAAS,CACZ,WAAYA,EAAE,IACd,MAAOA,EAAE,MAAQA,EAAE,IACnB,YAAaA,EAAE,YACf,eAAgBA,EAAE,aAClB,GAAIA,EAAE,YAAc,CAAA,CAAC,CACF,EAEvB,OAAO,IACT,CAEA,OAAOC,EAAkD,CACvD,OAAO,KAAK,UAAU,IAAIA,CAAU,CACtC,CAEA,MAA2B,CACzB,MAAO,CAAC,GAAG,KAAK,UAAU,QAAQ,CACpC,CAEA,eAAeC,EAAsC,CACnD,OAAO,KAAK,OAAO,OAAQF,GAAMA,EAAE,WAAaE,CAAQ,CAC1D,CAEA,UAAUC,EAAiC,CACzC,OAAO,KAAK,KAAA,EAAO,OAAQH,UAAM,OAAAI,EAAAJ,EAAE,OAAF,YAAAI,EAAQ,SAASD,GAAI,CACxD,CAEA,OAAOE,EAAmC,CACxC,MAAMC,EAAID,EAAM,YAAA,EAChB,OAAO,KAAK,OAAO,OAChBL,GAAA,WACC,OAAAA,EAAE,MAAM,cAAc,SAASM,CAAC,KAChCF,EAAAJ,EAAE,cAAF,YAAAI,EAAe,cAAc,SAASE,OACtCC,EAAAP,EAAE,OAAF,YAAAO,EAAQ,KAAMJ,GAAQA,EAAI,cAAc,SAASG,CAAC,OAClDE,EAAAR,EAAE,WAAF,YAAAQ,EAAY,cAAc,SAASF,IAAC,CAE1C,CAEA,YAAuB,CACrB,MAAMG,MAAW,IACjB,YAAK,KAAA,EAAO,QAAST,GAAM,CAAMA,EAAE,UAAUS,EAAK,IAAIT,EAAE,QAAQ,CAAG,CAAC,EAC7D,MAAM,KAAKS,CAAI,CACxB,CAGA,OAAc,CACZ,YAAK,UAAU,MAAA,EACR,IACT,CACF,CAEO,MAAMC,EAAmB,IAAId"}

package/dist/templateRegistry.d.ts

@@ -1,5 +1,21 @@
 import { ReactNode } from 'react';
 
+/**
+ * Wire shape the backend `/api/v1/workflow-template` endpoint is expected
+ * to return. Top-level fields mirror the persistence model; everything
+ * UI-related lives under `templateUI`. Use with `templateRegistry.registerFromApi(list)`.
+ */
+export declare interface ApiWorkflowTemplate {
+    key: string;
+    name: string;
+    state?: string;
+    description?: string;
+    allowedTasks?: string[];
+    allowedSources?: string[];
+    configuration?: Record<string, unknown>;
+    templateUI?: Partial<Omit<WorkflowTemplate, 'triggerKey' | 'label' | 'description' | 'availableTasks'>>;
+}
+
 declare type BranchChain = CanvasSlot[];
 
 declare interface BranchMap {
@@ -38,13 +54,40 @@ declare type SlotKind = 'start' | 'end' | 'addTrigger' | 'triggerFixed' | 'userT
 
 export declare class TemplateRegistry {
     private templates;
+    /**
+     * Register a template. Normalises `allowedTasks` (the backend's name) →
+     * `availableTasks` (FlowForge's canonical name) so consumers can pass
+     * either without rewriting.
+     */
     register(template: WorkflowTemplate): this;
+    /**
+     * Register a list of templates fetched from `GET /api/v1/workflow-template`.
+     *
+     * The API shape is:
+     *   {
+     *     key, name, description, allowedTasks, allowedSources,
+     *     configuration,            // runtime BPMN — ignored by the canvas
+     *     templateUI: {             // ← UI bag, spread onto the template
+     *       triggerCategory, icon, tags, category, author, popularity,
+     *       source, product, taskLabels, maxTasks, skeletonState, …
+     *     }
+     *   }
+     *
+     * Anything in `templateUI` overrides the top-level shorthand where there's
+     * an overlap. Bad rows (missing `key`) are skipped with a DEV warning
+     * rather than throwing, so one broken template doesn't blank the picker.
+     *
+     * Returns `this` for chaining and the count of templates registered.
+     */
+    registerFromApi(list: ApiWorkflowTemplate[]): this;
     lookup(triggerKey: string): WorkflowTemplate | undefined;
     list(): WorkflowTemplate[];
     listByCategory(category: string): WorkflowTemplate[];
     listByTag(tag: string): WorkflowTemplate[];
     search(query: string): WorkflowTemplate[];
     categories(): string[];
+    /** Remove every template — useful before re-loading from backend. */
+    clear(): this;
 }
 
 export declare const templateRegistry: TemplateRegistry;
@@ -60,7 +103,13 @@ export declare interface WorkflowTemplate {
     description?: string;
     icon?: ReactNode;
     triggerCategory?: 'event' | 'scheduler' | 'webhook' | string;
+    /**
+     * Task IDs (descriptor types) that can be inserted into this workflow.
+     * `allowedTasks` is accepted as an alias for backend payloads that use
+     * that name — TemplateRegistry.register() normalises them.
+     */
     availableTasks?: string[];
+    allowedTasks?: string[];
     maxTasks?: number;
     taskLabels?: Record<string, string>;
     fixedNodes?: FixedNode[];

package/dist/templateRegistry.js

@@ -1,44 +1,87 @@
-class l {
+class o {
   constructor() {
     this.templates = /* @__PURE__ */ new Map();
   }
-  register(e) {
+  /**
+   * Register a template. Normalises `allowedTasks` (the backend's name) →
+   * `availableTasks` (FlowForge's canonical name) so consumers can pass
+   * either without rewriting.
+   */
+  register(t) {
+    const e = {
+      ...t,
+      availableTasks: t.availableTasks ?? t.allowedTasks
+    };
     return this.templates.set(e.triggerKey, e), this;
   }
-  lookup(e) {
-    return this.templates.get(e);
+  /**
+   * Register a list of templates fetched from `GET /api/v1/workflow-template`.
+   *
+   * The API shape is:
+   *   {
+   *     key, name, description, allowedTasks, allowedSources,
+   *     configuration,            // runtime BPMN — ignored by the canvas
+   *     templateUI: {             // ← UI bag, spread onto the template
+   *       triggerCategory, icon, tags, category, author, popularity,
+   *       source, product, taskLabels, maxTasks, skeletonState, …
+   *     }
+   *   }
+   *
+   * Anything in `templateUI` overrides the top-level shorthand where there's
+   * an overlap. Bad rows (missing `key`) are skipped with a DEV warning
+   * rather than throwing, so one broken template doesn't blank the picker.
+   *
+   * Returns `this` for chaining and the count of templates registered.
+   */
+  registerFromApi(t) {
+    for (const e of t ?? [])
+      e != null && e.key && this.register({
+        triggerKey: e.key,
+        label: e.name ?? e.key,
+        description: e.description,
+        availableTasks: e.allowedTasks,
+        ...e.templateUI ?? {}
+      });
+    return this;
+  }
+  lookup(t) {
+    return this.templates.get(t);
   }
   list() {
     return [...this.templates.values()];
   }
-  listByCategory(e) {
-    return this.list().filter((t) => t.category === e);
+  listByCategory(t) {
+    return this.list().filter((e) => e.category === t);
   }
-  listByTag(e) {
-    return this.list().filter((t) => {
+  listByTag(t) {
+    return this.list().filter((e) => {
       var s;
-      return (s = t.tags) == null ? void 0 : s.includes(e);
+      return (s = e.tags) == null ? void 0 : s.includes(t);
     });
   }
-  search(e) {
-    const t = e.toLowerCase();
+  search(t) {
+    const e = t.toLowerCase();
     return this.list().filter(
       (s) => {
-        var r, i, a;
-        return s.label.toLowerCase().includes(t) || ((r = s.description) == null ? void 0 : r.toLowerCase().includes(t)) || ((i = s.tags) == null ? void 0 : i.some((o) => o.toLowerCase().includes(t))) || ((a = s.category) == null ? void 0 : a.toLowerCase().includes(t));
+        var r, a, i;
+        return s.label.toLowerCase().includes(e) || ((r = s.description) == null ? void 0 : r.toLowerCase().includes(e)) || ((a = s.tags) == null ? void 0 : a.some((l) => l.toLowerCase().includes(e))) || ((i = s.category) == null ? void 0 : i.toLowerCase().includes(e));
       }
     );
   }
   categories() {
-    const e = /* @__PURE__ */ new Set();
-    return this.list().forEach((t) => {
-      t.category && e.add(t.category);
-    }), Array.from(e);
+    const t = /* @__PURE__ */ new Set();
+    return this.list().forEach((e) => {
+      e.category && t.add(e.category);
+    }), Array.from(t);
+  }
+  /** Remove every template — useful before re-loading from backend. */
+  clear() {
+    return this.templates.clear(), this;
   }
 }
-const n = new l();
+const c = new o();
 export {
-  l as TemplateRegistry,
-  n as templateRegistry
+  o as TemplateRegistry,
+  c as templateRegistry
 };
 //# sourceMappingURL=templateRegistry.js.map

package/dist/templateRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"templateRegistry.js","sources":["../src/templateRegistry/index.ts"],"sourcesContent":["import { WorkflowTemplate } from '../WorkflowCanvas/types';\r\n\r\nexport class TemplateRegistry {\r\n  private templates = new Map<string, WorkflowTemplate>();\r\n\r\n  register(template: WorkflowTemplate): this {\r\n    this.templates.set(template.triggerKey, template);\r\n    return this;\r\n  }\r\n\r\n  lookup(triggerKey: string): WorkflowTemplate | undefined {\r\n    return this.templates.get(triggerKey);\r\n  }\r\n\r\n  list(): WorkflowTemplate[] {\r\n    return [...this.templates.values()];\r\n  }\r\n\r\n  listByCategory(category: string): WorkflowTemplate[] {\r\n    return this.list().filter((t) => t.category === category);\r\n  }\r\n\r\n  listByTag(tag: string): WorkflowTemplate[] {\r\n    return this.list().filter((t) => t.tags?.includes(tag));\r\n  }\r\n\r\n  search(query: string): WorkflowTemplate[] {\r\n    const q = query.toLowerCase();\r\n    return this.list().filter(\r\n      (t) =>\r\n        t.label.toLowerCase().includes(q) ||\r\n        t.description?.toLowerCase().includes(q) ||\r\n        t.tags?.some((tag) => tag.toLowerCase().includes(q)) ||\r\n        t.category?.toLowerCase().includes(q),\r\n    );\r\n  }\r\n\r\n  categories(): string[] {\r\n    const cats = new Set<string>();\r\n    this.list().forEach((t) => { if (t.category) cats.add(t.category); });\r\n    return Array.from(cats);\r\n  }\r\n}\r\n\r\nexport const templateRegistry = new TemplateRegistry();\r\nexport type { WorkflowTemplate };\r\n"],"names":["TemplateRegistry","template","triggerKey","category","tag","_a","query","q","t","_b","_c","cats","templateRegistry"],"mappings":"AAEO,MAAMA,EAAiB;AAAA,EAAvB,cAAA;AACL,SAAQ,gCAAgB,IAAA;AAAA,EAA8B;AAAA,EAEtD,SAASC,GAAkC;AACzC,gBAAK,UAAU,IAAIA,EAAS,YAAYA,CAAQ,GACzC;AAAA,EACT;AAAA,EAEA,OAAOC,GAAkD;AACvD,WAAO,KAAK,UAAU,IAAIA,CAAU;AAAA,EACtC;AAAA,EAEA,OAA2B;AACzB,WAAO,CAAC,GAAG,KAAK,UAAU,QAAQ;AAAA,EACpC;AAAA,EAEA,eAAeC,GAAsC;AACnD,WAAO,KAAK,OAAO,OAAO,CAAC,MAAM,EAAE,aAAaA,CAAQ;AAAA,EAC1D;AAAA,EAEA,UAAUC,GAAiC;AACzC,WAAO,KAAK,KAAA,EAAO,OAAO,CAAC;AArBxB,UAAAC;AAqB8B,cAAAA,IAAA,EAAE,SAAF,gBAAAA,EAAQ,SAASD;AAAA,KAAI;AAAA,EACxD;AAAA,EAEA,OAAOE,GAAmC;AACxC,UAAMC,IAAID,EAAM,YAAA;AAChB,WAAO,KAAK,OAAO;AAAA,MACjB,CAACE,MAAA;AA3BA,YAAAH,GAAAI,GAAAC;AA4BC,eAAAF,EAAE,MAAM,cAAc,SAASD,CAAC,OAChCF,IAAAG,EAAE,gBAAF,gBAAAH,EAAe,cAAc,SAASE,SACtCE,IAAAD,EAAE,SAAF,gBAAAC,EAAQ,KAAK,CAACL,MAAQA,EAAI,cAAc,SAASG,CAAC,SAClDG,IAAAF,EAAE,aAAF,gBAAAE,EAAY,cAAc,SAASH;AAAA;AAAA,IAAC;AAAA,EAE1C;AAAA,EAEA,aAAuB;AACrB,UAAMI,wBAAW,IAAA;AACjB,gBAAK,KAAA,EAAO,QAAQ,CAAC,MAAM;AAAE,MAAI,EAAE,YAAUA,EAAK,IAAI,EAAE,QAAQ;AAAA,IAAG,CAAC,GAC7D,MAAM,KAAKA,CAAI;AAAA,EACxB;AACF;AAEO,MAAMC,IAAmB,IAAIZ,EAAA;"}
+{"version":3,"file":"templateRegistry.js","sources":["../src/templateRegistry/index.ts"],"sourcesContent":["import type { WorkflowTemplate, ApiWorkflowTemplate } from '../WorkflowCanvas/types';\n\nexport class TemplateRegistry {\n  private templates = new Map<string, WorkflowTemplate>();\n\n  /**\n   * Register a template. Normalises `allowedTasks` (the backend's name) →\n   * `availableTasks` (FlowForge's canonical name) so consumers can pass\n   * either without rewriting.\n   */\n  register(template: WorkflowTemplate): this {\n    const normalised: WorkflowTemplate = {\n      ...template,\n      availableTasks: template.availableTasks ?? template.allowedTasks,\n    };\n    this.templates.set(normalised.triggerKey, normalised);\n    return this;\n  }\n\n  /**\n   * Register a list of templates fetched from `GET /api/v1/workflow-template`.\n   *\n   * The API shape is:\n   *   {\n   *     key, name, description, allowedTasks, allowedSources,\n   *     configuration,            // runtime BPMN — ignored by the canvas\n   *     templateUI: {             // ← UI bag, spread onto the template\n   *       triggerCategory, icon, tags, category, author, popularity,\n   *       source, product, taskLabels, maxTasks, skeletonState, …\n   *     }\n   *   }\n   *\n   * Anything in `templateUI` overrides the top-level shorthand where there's\n   * an overlap. Bad rows (missing `key`) are skipped with a DEV warning\n   * rather than throwing, so one broken template doesn't blank the picker.\n   *\n   * Returns `this` for chaining and the count of templates registered.\n   */\n  registerFromApi(list: ApiWorkflowTemplate[]): this {\n    for (const t of list ?? []) {\n      if (!t?.key) {\n        if (import.meta.env?.DEV) {\n          // eslint-disable-next-line no-console\n          console.warn('[FlowForge] templateRegistry.registerFromApi: skipped row without `key`', t);\n        }\n        continue;\n      }\n      this.register({\n        triggerKey: t.key,\n        label: t.name ?? t.key,\n        description: t.description,\n        availableTasks: t.allowedTasks,\n        ...(t.templateUI ?? {}),\n      } as WorkflowTemplate);\n    }\n    return this;\n  }\n\n  lookup(triggerKey: string): WorkflowTemplate | undefined {\n    return this.templates.get(triggerKey);\n  }\n\n  list(): WorkflowTemplate[] {\n    return [...this.templates.values()];\n  }\n\n  listByCategory(category: string): WorkflowTemplate[] {\n    return this.list().filter((t) => t.category === category);\n  }\n\n  listByTag(tag: string): WorkflowTemplate[] {\n    return this.list().filter((t) => t.tags?.includes(tag));\n  }\n\n  search(query: string): WorkflowTemplate[] {\n    const q = query.toLowerCase();\n    return this.list().filter(\n      (t) =>\n        t.label.toLowerCase().includes(q) ||\n        t.description?.toLowerCase().includes(q) ||\n        t.tags?.some((tag) => tag.toLowerCase().includes(q)) ||\n        t.category?.toLowerCase().includes(q),\n    );\n  }\n\n  categories(): string[] {\n    const cats = new Set<string>();\n    this.list().forEach((t) => { if (t.category) cats.add(t.category); });\n    return Array.from(cats);\n  }\n\n  /** Remove every template — useful before re-loading from backend. */\n  clear(): this {\n    this.templates.clear();\n    return this;\n  }\n}\n\nexport const templateRegistry = new TemplateRegistry();\nexport type { WorkflowTemplate, ApiWorkflowTemplate };\n"],"names":["TemplateRegistry","template","normalised","list","t","triggerKey","category","tag","_a","query","q","_b","_c","cats","templateRegistry"],"mappings":"AAEO,MAAMA,EAAiB;AAAA,EAAvB,cAAA;AACL,SAAQ,gCAAgB,IAAA;AAAA,EAA8B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOtD,SAASC,GAAkC;AACzC,UAAMC,IAA+B;AAAA,MACnC,GAAGD;AAAA,MACH,gBAAgBA,EAAS,kBAAkBA,EAAS;AAAA,IAAA;AAEtD,gBAAK,UAAU,IAAIC,EAAW,YAAYA,CAAU,GAC7C;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBA,gBAAgBC,GAAmC;AACjD,eAAWC,KAAKD,KAAQ;AACtB,MAAKC,KAAA,QAAAA,EAAG,OAOR,KAAK,SAAS;AAAA,QACZ,YAAYA,EAAE;AAAA,QACd,OAAOA,EAAE,QAAQA,EAAE;AAAA,QACnB,aAAaA,EAAE;AAAA,QACf,gBAAgBA,EAAE;AAAA,QAClB,GAAIA,EAAE,cAAc,CAAA;AAAA,MAAC,CACF;AAEvB,WAAO;AAAA,EACT;AAAA,EAEA,OAAOC,GAAkD;AACvD,WAAO,KAAK,UAAU,IAAIA,CAAU;AAAA,EACtC;AAAA,EAEA,OAA2B;AACzB,WAAO,CAAC,GAAG,KAAK,UAAU,QAAQ;AAAA,EACpC;AAAA,EAEA,eAAeC,GAAsC;AACnD,WAAO,KAAK,OAAO,OAAO,CAACF,MAAMA,EAAE,aAAaE,CAAQ;AAAA,EAC1D;AAAA,EAEA,UAAUC,GAAiC;AACzC,WAAO,KAAK,KAAA,EAAO,OAAO,CAACH;AArExB,UAAAI;AAqE8B,cAAAA,IAAAJ,EAAE,SAAF,gBAAAI,EAAQ,SAASD;AAAA,KAAI;AAAA,EACxD;AAAA,EAEA,OAAOE,GAAmC;AACxC,UAAMC,IAAID,EAAM,YAAA;AAChB,WAAO,KAAK,OAAO;AAAA,MACjB,CAACL,MAAA;AA3EA,YAAAI,GAAAG,GAAAC;AA4EC,eAAAR,EAAE,MAAM,cAAc,SAASM,CAAC,OAChCF,IAAAJ,EAAE,gBAAF,gBAAAI,EAAe,cAAc,SAASE,SACtCC,IAAAP,EAAE,SAAF,gBAAAO,EAAQ,KAAK,CAACJ,MAAQA,EAAI,cAAc,SAASG,CAAC,SAClDE,IAAAR,EAAE,aAAF,gBAAAQ,EAAY,cAAc,SAASF;AAAA;AAAA,IAAC;AAAA,EAE1C;AAAA,EAEA,aAAuB;AACrB,UAAMG,wBAAW,IAAA;AACjB,gBAAK,KAAA,EAAO,QAAQ,CAACT,MAAM;AAAE,MAAIA,EAAE,YAAUS,EAAK,IAAIT,EAAE,QAAQ;AAAA,IAAG,CAAC,GAC7D,MAAM,KAAKS,CAAI;AAAA,EACxB;AAAA;AAAA,EAGA,QAAc;AACZ,gBAAK,UAAU,MAAA,GACR;AAAA,EACT;AACF;AAEO,MAAMC,IAAmB,IAAId,EAAA;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@notmrabhi/flowforge",
-  "version": "0.1.35",
+  "version": "0.1.36",
   "description": "Schema-driven form renderer and workflow engine for miniOrange IAM",
   "license": "UNLICENSED",
   "author": "miniOrange",