@contractspec/lib.example-shared-ui 1.11.0 → 1.12.0

package/dist/node/hooks/useWorkflowComposer.js

@@ -0,0 +1,493 @@
+// src/hooks/useWorkflowComposer.ts
+import { useCallback, useEffect, useMemo, useState } from "react";
+"use client";
+function useWorkflowComposer(templateId) {
+  const [selectedWorkflow, setSelectedWorkflow] = useState(null);
+  const [extensions, setExtensions] = useState([]);
+  const [loading, _setLoading] = useState(false);
+  const [error, _setError] = useState(null);
+  const baseWorkflows = useMemo(() => getTemplateWorkflows(templateId), [templateId]);
+  useEffect(() => {
+    const firstWorkflow = baseWorkflows[0];
+    if (baseWorkflows.length > 0 && !selectedWorkflow && firstWorkflow) {
+      setSelectedWorkflow(firstWorkflow.meta.key);
+    }
+  }, [baseWorkflows, selectedWorkflow]);
+  const currentBase = useMemo(() => {
+    return baseWorkflows.find((w) => w.meta.key === selectedWorkflow) ?? null;
+  }, [baseWorkflows, selectedWorkflow]);
+  const compose = useCallback((scope) => {
+    if (!currentBase)
+      return null;
+    const applicableExtensions = extensions.filter((ext) => ext.workflow === currentBase.meta.key).filter((ext) => matchesScope(ext, scope)).sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0));
+    if (applicableExtensions.length === 0) {
+      return currentBase;
+    }
+    let composedWorkflow = { ...currentBase, steps: [...currentBase.steps] };
+    for (const extension of applicableExtensions) {
+      composedWorkflow = applyExtension(composedWorkflow, extension);
+    }
+    return composedWorkflow;
+  }, [currentBase, extensions]);
+  const workflow = useMemo(() => compose(), [compose]);
+  const selectWorkflow = useCallback((workflowName) => {
+    setSelectedWorkflow(workflowName);
+  }, []);
+  const addExtension = useCallback((extension) => {
+    setExtensions((prev) => [...prev, extension]);
+  }, []);
+  const removeExtension = useCallback((workflowName, index) => {
+    setExtensions((prev) => {
+      const forWorkflow = prev.filter((e) => e.workflow === workflowName);
+      const others = prev.filter((e) => e.workflow !== workflowName);
+      forWorkflow.splice(index, 1);
+      return [...others, ...forWorkflow];
+    });
+  }, []);
+  const generateSpecCode = useCallback(() => {
+    const composed = workflow;
+    if (!composed) {
+      return "// No workflow selected";
+    }
+    const stepsCode = composed.steps.map((step) => `    {
+      id: '${step.id}',
+      name: '${step.name}',
+      type: '${step.type}',${step.description ? `
+      description: '${step.description}',` : ""}${step.next ? `
+      next: ${JSON.stringify(step.next)},` : ""}${step.condition ? `
+      condition: '${step.condition}',` : ""}${step.timeout ? `
+      timeout: ${step.timeout},` : ""}${step.retries ? `
+      retries: ${step.retries},` : ""}${step.onError ? `
+      onError: '${step.onError}',` : ""}
+    }`).join(`,
+`);
+    const extensionsCode = extensions.length > 0 ? `
+
+// Extensions applied:
+${extensions.map((ext) => `// - ${ext.workflow} (priority: ${ext.priority ?? 0})${ext.customSteps?.length ? ` +${ext.customSteps.length} steps` : ""}${ext.hiddenSteps?.length ? ` -${ext.hiddenSteps.length} hidden` : ""}`).join(`
+`)}` : "";
+    return `// Workflow Spec: ${composed.meta.key} v${composed.meta.version}
+// Generated from ${templateId} template
+${extensionsCode}
+
+import { workflowSpec } from '@contractspec/lib.contracts/workflow';
+
+export const ${toCamelCase(composed.meta.key)}Workflow = workflowSpec({
+  meta: {
+    key: '${composed.meta.key}',
+    version: ${composed.meta.version},${composed.meta.description ? `
+    description: '${composed.meta.description}',` : ""}
+  },
+  start: '${composed.start}',
+  steps: [
+${stepsCode}
+  ],${composed.context ? `
+  context: ${JSON.stringify(composed.context, null, 2)},` : ""}
+});
+`;
+  }, [workflow, extensions, templateId]);
+  return {
+    workflow,
+    baseWorkflows,
+    extensions,
+    selectWorkflow,
+    addExtension,
+    removeExtension,
+    compose,
+    generateSpecCode,
+    loading,
+    error
+  };
+}
+function matchesScope(extension, scope) {
+  if (!scope)
+    return true;
+  if (extension.tenantId && extension.tenantId !== scope.tenantId) {
+    return false;
+  }
+  if (extension.role && extension.role !== scope.role) {
+    return false;
+  }
+  if (extension.device && extension.device !== scope.device) {
+    return false;
+  }
+  return true;
+}
+function applyExtension(workflow, extension) {
+  let steps = [...workflow.steps];
+  if (extension.hiddenSteps) {
+    steps = steps.filter((s) => !extension.hiddenSteps?.includes(s.id));
+  }
+  if (extension.customSteps) {
+    for (const injection of extension.customSteps) {
+      const stepToInject = {
+        ...injection.inject,
+        id: injection.id ?? injection.inject.id
+      };
+      if (injection.after) {
+        const afterIndex = steps.findIndex((s) => s.id === injection.after);
+        if (afterIndex !== -1) {
+          steps.splice(afterIndex + 1, 0, stepToInject);
+        }
+      } else if (injection.before) {
+        const beforeIndex = steps.findIndex((s) => s.id === injection.before);
+        if (beforeIndex !== -1) {
+          steps.splice(beforeIndex, 0, stepToInject);
+        }
+      } else {
+        steps.push(stepToInject);
+      }
+    }
+  }
+  return { ...workflow, steps };
+}
+function toCamelCase(str) {
+  return str.replace(/[^a-zA-Z0-9]+(.)/g, (_, c) => c.toUpperCase()).replace(/^./, (c) => c.toLowerCase());
+}
+function getTemplateWorkflows(templateId) {
+  const templateWorkflows = {
+    "crm-pipeline": [
+      {
+        meta: {
+          key: "deal.qualification",
+          version: "1.0.0",
+          description: "Deal qualification workflow"
+        },
+        start: "lead-received",
+        steps: [
+          {
+            id: "lead-received",
+            name: "Lead Received",
+            type: "action",
+            description: "New lead enters the pipeline",
+            next: "qualify-lead"
+          },
+          {
+            id: "qualify-lead",
+            name: "Qualify Lead",
+            type: "decision",
+            description: "Determine if lead meets qualification criteria",
+            next: ["qualified", "disqualified"],
+            condition: "lead.score >= threshold"
+          },
+          {
+            id: "qualified",
+            name: "Lead Qualified",
+            type: "action",
+            next: "assign-rep"
+          },
+          {
+            id: "disqualified",
+            name: "Lead Disqualified",
+            type: "end"
+          },
+          {
+            id: "assign-rep",
+            name: "Assign Sales Rep",
+            type: "action",
+            next: "complete"
+          },
+          {
+            id: "complete",
+            name: "Workflow Complete",
+            type: "end"
+          }
+        ]
+      },
+      {
+        meta: {
+          key: "deal.closing",
+          version: "1.0.0",
+          description: "Deal closing workflow"
+        },
+        start: "proposal-sent",
+        steps: [
+          {
+            id: "proposal-sent",
+            name: "Proposal Sent",
+            type: "action",
+            next: "wait-response"
+          },
+          {
+            id: "wait-response",
+            name: "Wait for Response",
+            type: "wait",
+            timeout: 604800000,
+            next: "negotiate",
+            onError: "follow-up"
+          },
+          {
+            id: "follow-up",
+            name: "Follow Up",
+            type: "action",
+            next: "wait-response",
+            retries: 3
+          },
+          {
+            id: "negotiate",
+            name: "Negotiation",
+            type: "action",
+            next: "finalize"
+          },
+          {
+            id: "finalize",
+            name: "Finalize Deal",
+            type: "decision",
+            next: ["won", "lost"],
+            condition: "deal.accepted"
+          },
+          {
+            id: "won",
+            name: "Deal Won",
+            type: "end"
+          },
+          {
+            id: "lost",
+            name: "Deal Lost",
+            type: "end"
+          }
+        ]
+      }
+    ],
+    "saas-boilerplate": [
+      {
+        meta: {
+          key: "user.onboarding",
+          version: "1.0.0",
+          description: "User onboarding workflow"
+        },
+        start: "signup",
+        steps: [
+          {
+            id: "signup",
+            name: "User Signup",
+            type: "action",
+            next: "verify-email"
+          },
+          {
+            id: "verify-email",
+            name: "Verify Email",
+            type: "wait",
+            timeout: 86400000,
+            next: "profile-setup",
+            onError: "resend-verification"
+          },
+          {
+            id: "resend-verification",
+            name: "Resend Verification",
+            type: "action",
+            next: "verify-email",
+            retries: 2
+          },
+          {
+            id: "profile-setup",
+            name: "Setup Profile",
+            type: "action",
+            next: "onboarding-tour"
+          },
+          {
+            id: "onboarding-tour",
+            name: "Onboarding Tour",
+            type: "action",
+            next: "complete"
+          },
+          {
+            id: "complete",
+            name: "Onboarding Complete",
+            type: "end"
+          }
+        ]
+      }
+    ],
+    "agent-console": [
+      {
+        meta: {
+          key: "agent.execution",
+          version: "1.0.0",
+          description: "Agent execution workflow"
+        },
+        start: "receive-task",
+        steps: [
+          {
+            id: "receive-task",
+            name: "Receive Task",
+            type: "action",
+            next: "plan-execution"
+          },
+          {
+            id: "plan-execution",
+            name: "Plan Execution",
+            type: "action",
+            next: "execute-steps"
+          },
+          {
+            id: "execute-steps",
+            name: "Execute Steps",
+            type: "parallel",
+            next: ["tool-call", "observe", "reason"]
+          },
+          {
+            id: "tool-call",
+            name: "Tool Call",
+            type: "action",
+            next: "evaluate"
+          },
+          {
+            id: "observe",
+            name: "Observe",
+            type: "action",
+            next: "evaluate"
+          },
+          {
+            id: "reason",
+            name: "Reason",
+            type: "action",
+            next: "evaluate"
+          },
+          {
+            id: "evaluate",
+            name: "Evaluate Result",
+            type: "decision",
+            condition: "task.isComplete",
+            next: ["complete", "execute-steps"]
+          },
+          {
+            id: "complete",
+            name: "Task Complete",
+            type: "end"
+          }
+        ]
+      }
+    ],
+    "todos-app": [
+      {
+        meta: {
+          key: "task.lifecycle",
+          version: "1.0.0",
+          description: "Task lifecycle workflow"
+        },
+        start: "created",
+        steps: [
+          {
+            id: "created",
+            name: "Task Created",
+            type: "action",
+            next: "in-progress"
+          },
+          {
+            id: "in-progress",
+            name: "In Progress",
+            type: "action",
+            next: "review"
+          },
+          {
+            id: "review",
+            name: "Review",
+            type: "decision",
+            condition: "task.approved",
+            next: ["done", "in-progress"]
+          },
+          {
+            id: "done",
+            name: "Done",
+            type: "end"
+          }
+        ]
+      }
+    ],
+    "messaging-app": [
+      {
+        meta: {
+          key: "message.delivery",
+          version: "1.0.0",
+          description: "Message delivery workflow"
+        },
+        start: "compose",
+        steps: [
+          {
+            id: "compose",
+            name: "Compose Message",
+            type: "action",
+            next: "send"
+          },
+          {
+            id: "send",
+            name: "Send Message",
+            type: "action",
+            next: "deliver"
+          },
+          {
+            id: "deliver",
+            name: "Deliver",
+            type: "decision",
+            condition: "recipient.online",
+            next: ["delivered", "queue"]
+          },
+          {
+            id: "queue",
+            name: "Queue for Delivery",
+            type: "wait",
+            next: "deliver"
+          },
+          {
+            id: "delivered",
+            name: "Message Delivered",
+            type: "action",
+            next: "read"
+          },
+          {
+            id: "read",
+            name: "Message Read",
+            type: "end"
+          }
+        ]
+      }
+    ],
+    "recipe-app-i18n": [
+      {
+        meta: {
+          key: "recipe.creation",
+          version: "1.0.0",
+          description: "Recipe creation workflow"
+        },
+        start: "draft",
+        steps: [
+          {
+            id: "draft",
+            name: "Draft Recipe",
+            type: "action",
+            next: "add-ingredients"
+          },
+          {
+            id: "add-ingredients",
+            name: "Add Ingredients",
+            type: "action",
+            next: "add-steps"
+          },
+          {
+            id: "add-steps",
+            name: "Add Steps",
+            type: "action",
+            next: "review"
+          },
+          {
+            id: "review",
+            name: "Review Recipe",
+            type: "decision",
+            condition: "recipe.isComplete",
+            next: ["publish", "draft"]
+          },
+          {
+            id: "publish",
+            name: "Publish Recipe",
+            type: "end"
+          }
+        ]
+      }
+    ]
+  };
+  return templateWorkflows[templateId] ?? [];
+}
+export {
+  useWorkflowComposer
+};