@particle-academy/fancy-flow 0.2.2

package/dist/registry.cjs

@@ -0,0 +1,615 @@
+'use strict';
+
+var react = require('react');
+var react$1 = require('@xyflow/react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/registry/registry.ts
+var kinds = /* @__PURE__ */ new Map();
+var listeners = /* @__PURE__ */ new Set();
+function registerNodeKind(definition) {
+  kinds.set(definition.name, definition);
+  notify();
+  return () => {
+    if (kinds.get(definition.name) === definition) {
+      kinds.delete(definition.name);
+      notify();
+    }
+  };
+}
+function getNodeKind(name) {
+  return kinds.get(name) ?? null;
+}
+function listNodeKinds(category) {
+  const all = Array.from(kinds.values());
+  return category ? all.filter((k) => k.category === category) : all;
+}
+function onNodeKindsChanged(listener) {
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}
+function notify() {
+  for (const l of listeners) l();
+}
+function defaultConfigFor(kind) {
+  const fromKind = kind.defaultConfig ? { ...kind.defaultConfig } : {};
+  for (const field of kind.configSchema ?? []) {
+    if (fromKind[field.key] !== void 0) continue;
+    if ("default" in field && field.default !== void 0) {
+      fromKind[field.key] = field.default;
+    }
+  }
+  return fromKind;
+}
+function validateConfig(kind, config) {
+  const issues = [];
+  for (const field of kind.configSchema ?? []) {
+    const value = config[field.key];
+    if (field.required && (value === void 0 || value === null || value === "")) {
+      issues.push({ key: field.key, message: `${field.label} is required` });
+      continue;
+    }
+    if (value === void 0 || value === null) continue;
+    const issue = validateField(field, value);
+    if (issue) issues.push({ key: field.key, message: issue });
+  }
+  return issues;
+}
+function validateField(field, value) {
+  switch (field.type) {
+    case "text":
+    case "textarea":
+    case "expression":
+    case "credential":
+      return typeof value === "string" ? null : `${field.label} must be a string`;
+    case "number": {
+      if (typeof value !== "number" || !Number.isFinite(value)) return `${field.label} must be a number`;
+      if (field.min !== void 0 && value < field.min) return `${field.label} must be >= ${field.min}`;
+      if (field.max !== void 0 && value > field.max) return `${field.label} must be <= ${field.max}`;
+      return null;
+    }
+    case "switch":
+      return typeof value === "boolean" ? null : `${field.label} must be a boolean`;
+    case "select": {
+      const allowed = field.options.map((o) => o.value);
+      return allowed.includes(String(value)) ? null : `${field.label} must be one of ${allowed.join(", ")}`;
+    }
+    case "json":
+      return null;
+    // permissive — just JSON-shaped
+    default:
+      return null;
+  }
+}
+function categoryAccent(category) {
+  switch (category) {
+    case "trigger":
+      return "#10b981";
+    case "logic":
+      return "#f59e0b";
+    case "data":
+      return "#0ea5e9";
+    case "ai":
+      return "#8b5cf6";
+    case "io":
+      return "#3b82f6";
+    case "human":
+      return "#ec4899";
+    case "output":
+      return "#a855f7";
+    default:
+      return "#71717a";
+  }
+}
+function RegistryNodeInner(props) {
+  const kindName = props.data.kind ?? props.type;
+  const kind = react.useMemo(() => getNodeKind(kindName), [kindName]);
+  if (!kind) {
+    return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "ff-node ff-node--unknown", children: [
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "ff-node__header", style: { background: "#71717a" }, children: [
+        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ff-node__tag", children: "UNKNOWN" }),
+        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ff-node__label", children: kindName })
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "ff-node__desc", children: [
+        'No registered kind for "',
+        kindName,
+        '".'
+      ] })
+    ] });
+  }
+  const data = props.data;
+  const status = data.status ?? "idle";
+  const accent = kind.accent ?? categoryAccent(kind.category);
+  const inputs = data.inputs ?? kind.inputs ?? defaultInputs(kind.category);
+  const outputs = data.outputs ?? kind.outputs ?? defaultOutputs(kind.category);
+  const config = data.config ?? {};
+  const label = data.label ?? kind.label;
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      className: [
+        "ff-node",
+        `ff-node--status-${status}`,
+        `ff-node--cat-${kind.category}`,
+        props.selected ? "ff-node--selected" : ""
+      ].filter(Boolean).join(" "),
+      style: { borderColor: props.selected ? accent : void 0 },
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsxs("header", { className: "ff-node__header", style: { background: accent }, children: [
+          kind.icon && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ff-node__icon", "aria-hidden": true, children: kind.icon }),
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ff-node__tag", children: kind.label.toUpperCase() }),
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ff-node__label", children: label }),
+          status !== "idle" && /* @__PURE__ */ jsxRuntime.jsx("span", { className: `ff-node__dot ff-node__dot--${status}`, "aria-label": `status ${status}` })
+        ] }),
+        data.description && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "ff-node__desc", children: data.description }),
+        /* @__PURE__ */ jsxRuntime.jsx("div", { className: "ff-node__body", children: kind.renderBody ? kind.renderBody({ nodeId: props.id, config, selected: props.selected ?? false }) : /* @__PURE__ */ jsxRuntime.jsx(DefaultBody, { config, kind: kind.configSchema }) }),
+        data.statusText && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "ff-node__status-text", children: data.statusText }),
+        inputs.map((p, i) => /* @__PURE__ */ jsxRuntime.jsx(
+          react$1.Handle,
+          {
+            type: "target",
+            position: react$1.Position.Left,
+            id: p.id,
+            style: portStyle(i, inputs.length),
+            title: p.label ?? p.id
+          },
+          p.id
+        )),
+        outputs.map((p, i) => /* @__PURE__ */ jsxRuntime.jsx(
+          react$1.Handle,
+          {
+            type: "source",
+            position: react$1.Position.Right,
+            id: p.id,
+            style: portStyle(i, outputs.length),
+            title: p.label ?? p.id
+          },
+          p.id
+        ))
+      ]
+    }
+  );
+}
+var RegistryNode = react.memo(RegistryNodeInner);
+function defaultInputs(category) {
+  return category === "trigger" ? [] : [{ id: "in" }];
+}
+function defaultOutputs(category) {
+  return category === "output" ? [] : [{ id: "out" }];
+}
+function portStyle(i, total) {
+  if (total <= 1) return {};
+  const slot = 100 / (total + 1) * (i + 1);
+  return { top: `${slot}%` };
+}
+function DefaultBody({ config, kind }) {
+  const fields = kind ?? [];
+  const visible = fields.map((f) => ({ field: f, value: config[f.key] })).filter(({ value }) => value !== void 0 && value !== "" && value !== null);
+  if (visible.length === 0) {
+    return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "ff-node__body-empty", children: "\u2014 configure in the panel" });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsxs("ul", { className: "ff-node__summary", children: [
+    visible.slice(0, 4).map(({ field, value }) => /* @__PURE__ */ jsxRuntime.jsxs("li", { children: [
+      /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "ff-node__summary-key", children: [
+        field.label,
+        ":"
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ff-node__summary-value", children: previewValue(value) })
+    ] }, field.key)),
+    visible.length > 4 && /* @__PURE__ */ jsxRuntime.jsxs("li", { className: "ff-node__summary-more", children: [
+      "+ ",
+      visible.length - 4,
+      " more"
+    ] })
+  ] });
+}
+function previewValue(v) {
+  if (typeof v === "string") return v.length > 30 ? v.slice(0, 27) + "\u2026" : v;
+  if (typeof v === "number" || typeof v === "boolean") return String(v);
+  try {
+    const j = JSON.stringify(v);
+    return j.length > 30 ? j.slice(0, 27) + "\u2026" : j;
+  } catch {
+    return "[object]";
+  }
+}
+
+// src/registry/builtin.ts
+var HTTP_METHODS = [
+  { type: "select", key: "method", label: "Method", options: [
+    { value: "GET", label: "GET" },
+    { value: "POST", label: "POST" },
+    { value: "PUT", label: "PUT" },
+    { value: "PATCH", label: "PATCH" },
+    { value: "DELETE", label: "DELETE" }
+  ], default: "GET", required: true }
+];
+var KINDS = [
+  // ───────────── Triggers ─────────────
+  {
+    name: "manual_trigger",
+    category: "trigger",
+    label: "Manual",
+    description: "Entry point fired when the user clicks Run.",
+    icon: "\u26A1",
+    inputs: [],
+    outputs: [{ id: "out" }]
+  },
+  {
+    name: "webhook_trigger",
+    category: "trigger",
+    label: "Webhook",
+    description: "Triggered by an inbound HTTP request to a host-provided URL.",
+    icon: "\u{1F4E1}",
+    inputs: [],
+    outputs: [{ id: "out", label: "payload" }],
+    configSchema: [
+      { type: "text", key: "path", label: "Path", placeholder: "/hooks/my-flow", required: true },
+      { type: "select", key: "method", label: "Method", options: [
+        { value: "POST", label: "POST" },
+        { value: "GET", label: "GET" }
+      ], default: "POST" },
+      { type: "credential", key: "secret", label: "Verifying secret", credentialType: "webhook_secret" }
+    ]
+  },
+  {
+    name: "schedule_trigger",
+    category: "trigger",
+    label: "Schedule",
+    description: "Fires on a cron schedule (host-implemented).",
+    icon: "\u23F1",
+    inputs: [],
+    outputs: [{ id: "out" }],
+    configSchema: [
+      {
+        type: "text",
+        key: "cron",
+        label: "Cron",
+        placeholder: "*/5 * * * *",
+        required: true,
+        description: "Standard 5-field cron expression."
+      },
+      { type: "text", key: "timezone", label: "Timezone", placeholder: "UTC", default: "UTC" }
+    ]
+  },
+  {
+    name: "user_input",
+    category: "human",
+    label: "User Input",
+    description: "Pause the flow until the user submits the configured form.",
+    icon: "\u270E",
+    inputs: [{ id: "in" }],
+    outputs: [{ id: "out", label: "values" }],
+    configSchema: [
+      { type: "text", key: "title", label: "Form title", default: "Need your input" },
+      {
+        type: "json",
+        key: "fields",
+        label: "Fields (JSON)",
+        language: "json",
+        rows: 6,
+        default: [{ key: "answer", label: "Your answer", type: "textarea" }]
+      }
+    ]
+  },
+  // ───────────── Logic ─────────────
+  {
+    name: "branch",
+    category: "logic",
+    label: "Branch",
+    description: "Multi-way branch on a condition or value.",
+    icon: "\u25C7",
+    inputs: [{ id: "in" }],
+    outputs: [{ id: "true", label: "true" }, { id: "false", label: "false" }],
+    configSchema: [
+      { type: "expression", key: "condition", label: "Condition", example: "{{ $json.active }}", required: true }
+    ]
+  },
+  {
+    name: "switch_case",
+    category: "logic",
+    label: "Switch",
+    description: "Route to one of N labelled outputs based on a key.",
+    icon: "\u2933",
+    inputs: [{ id: "in" }],
+    outputs: [{ id: "case_a", label: "a" }, { id: "case_b", label: "b" }, { id: "default", label: "default" }],
+    configSchema: [
+      { type: "expression", key: "value", label: "Switch on", example: "{{ $json.kind }}", required: true },
+      { type: "json", key: "cases", label: "Cases (JSON)", default: { a: "case_a", b: "case_b" } }
+    ]
+  },
+  {
+    name: "for_each",
+    category: "logic",
+    label: "For Each",
+    description: "Iterate over a list, emitting each item on `item`.",
+    icon: "\u21BB",
+    inputs: [{ id: "in" }],
+    outputs: [{ id: "item", label: "item" }, { id: "done", label: "done" }],
+    configSchema: [
+      { type: "expression", key: "source", label: "List", example: "{{ $json.users }}", required: true },
+      { type: "number", key: "concurrency", label: "Concurrency", default: 1, min: 1, max: 50 }
+    ]
+  },
+  {
+    name: "merge",
+    category: "logic",
+    label: "Merge",
+    description: "Combine multiple inputs into one object or array.",
+    icon: "\u2295",
+    inputs: [{ id: "a" }, { id: "b" }],
+    outputs: [{ id: "out" }],
+    configSchema: [
+      {
+        type: "select",
+        key: "mode",
+        label: "Mode",
+        default: "merge",
+        options: [{ value: "merge", label: "Object merge" }, { value: "concat", label: "Array concat" }]
+      }
+    ]
+  },
+  {
+    name: "wait",
+    category: "logic",
+    label: "Wait",
+    description: "Sleep or wait for an external event.",
+    icon: "\u23F8",
+    configSchema: [
+      {
+        type: "select",
+        key: "mode",
+        label: "Mode",
+        default: "duration",
+        options: [{ value: "duration", label: "Duration" }, { value: "until", label: "Until timestamp" }, { value: "event", label: "External event" }]
+      },
+      { type: "text", key: "duration", label: "Duration", placeholder: "5s, 10m, 1h", description: "Used when mode = duration." }
+    ]
+  },
+  {
+    name: "transform",
+    category: "logic",
+    label: "Transform",
+    description: "Reshape data with an expression.",
+    icon: "\u0192",
+    configSchema: [
+      {
+        type: "expression",
+        key: "expression",
+        label: "Expression",
+        example: "{{ { id: $json.id, name: $json.first + ' ' + $json.last } }}",
+        required: true
+      }
+    ]
+  },
+  // ───────────── Data ─────────────
+  {
+    name: "memory_store",
+    category: "data",
+    label: "Memory Store",
+    description: "Read or write per-conversation memory.",
+    icon: "\u{1F9E0}",
+    configSchema: [
+      {
+        type: "select",
+        key: "operation",
+        label: "Operation",
+        required: true,
+        default: "read",
+        options: [{ value: "read", label: "Read" }, { value: "write", label: "Write" }, { value: "append", label: "Append" }]
+      },
+      { type: "text", key: "key", label: "Key", placeholder: "user.preferences", required: true },
+      { type: "expression", key: "value", label: "Value (write/append only)", example: "{{ $json }}" },
+      { type: "credential", key: "store", label: "Memory store", credentialType: "memory_store" }
+    ]
+  },
+  {
+    name: "data_store",
+    category: "data",
+    label: "Data Store",
+    description: "Key-value or table read/write against a host store.",
+    icon: "\u{1F5C3}",
+    configSchema: [
+      {
+        type: "select",
+        key: "operation",
+        label: "Operation",
+        required: true,
+        default: "get",
+        options: [
+          { value: "get", label: "Get" },
+          { value: "set", label: "Set" },
+          { value: "delete", label: "Delete" },
+          { value: "query", label: "Query" },
+          { value: "list", label: "List" }
+        ]
+      },
+      { type: "text", key: "table", label: "Table / collection", required: true },
+      { type: "text", key: "key", label: "Key" },
+      { type: "json", key: "where", label: "Where (JSON)", description: "For query/list operations." },
+      { type: "expression", key: "value", label: "Value (set only)", example: "{{ $json }}" },
+      { type: "credential", key: "store", label: "Data store", credentialType: "data_store" }
+    ]
+  },
+  {
+    name: "variable",
+    category: "data",
+    label: "Variable",
+    description: "Workflow-scoped value used by other nodes.",
+    icon: "\u{1D4CD}",
+    configSchema: [
+      { type: "text", key: "name", label: "Name", required: true },
+      { type: "expression", key: "value", label: "Value", required: true }
+    ]
+  },
+  // ───────────── AI ─────────────
+  {
+    name: "llm_call",
+    category: "ai",
+    label: "LLM Call",
+    description: "Send a prompt + context to a model and receive a response.",
+    icon: "\u2726",
+    configSchema: [
+      {
+        type: "select",
+        key: "provider",
+        label: "Provider",
+        default: "anthropic",
+        options: [
+          { value: "anthropic", label: "Anthropic" },
+          { value: "openai", label: "OpenAI" },
+          { value: "custom", label: "Custom" }
+        ]
+      },
+      { type: "text", key: "model", label: "Model", placeholder: "claude-sonnet-4-5", required: true },
+      { type: "textarea", key: "system", label: "System prompt", rows: 4 },
+      { type: "expression", key: "prompt", label: "User prompt", example: "{{ $json.question }}", required: true },
+      { type: "number", key: "temperature", label: "Temperature", min: 0, max: 2, step: 0.1, default: 0.7 },
+      { type: "number", key: "max_tokens", label: "Max tokens", min: 1, max: 8192, default: 1024 },
+      { type: "json", key: "tools", label: "Tools (JSON)", description: "Optional Anthropic-style tool definitions." },
+      { type: "credential", key: "credential", label: "API credential", credentialType: "llm_credential" }
+    ]
+  },
+  {
+    name: "tool_use",
+    category: "ai",
+    label: "Tool Use",
+    description: "Hand control to a host-registered tool by name.",
+    icon: "\u{1F6E0}",
+    configSchema: [
+      { type: "text", key: "tool", label: "Tool name", placeholder: "search_index", required: true },
+      { type: "expression", key: "args", label: "Arguments", example: "{{ { query: $json.q } }}" }
+    ]
+  },
+  {
+    name: "embed_search",
+    category: "ai",
+    label: "Embed & Search",
+    description: "Embed a query and search a vector store.",
+    icon: "\u273A",
+    configSchema: [
+      { type: "expression", key: "query", label: "Query", required: true, example: "{{ $json.question }}" },
+      { type: "number", key: "topK", label: "Top K", default: 5, min: 1, max: 50 },
+      { type: "credential", key: "vectorStore", label: "Vector store", credentialType: "vector_store" }
+    ]
+  },
+  // ───────────── IO ─────────────
+  {
+    name: "api_request",
+    category: "io",
+    label: "API Request",
+    description: "HTTP request to any URL.",
+    icon: "\u2194",
+    configSchema: [
+      ...HTTP_METHODS,
+      { type: "text", key: "url", label: "URL", placeholder: "https://api.example.com/...", required: true },
+      { type: "json", key: "headers", label: "Headers", default: { "content-type": "application/json" } },
+      { type: "json", key: "body", label: "Body" },
+      { type: "credential", key: "auth", label: "Auth", credentialType: "api_credential" }
+    ]
+  },
+  {
+    name: "webhook_out",
+    category: "io",
+    label: "Send Webhook",
+    description: "POST a payload to a configured URL.",
+    icon: "\u2197",
+    configSchema: [
+      { type: "text", key: "url", label: "URL", required: true },
+      { type: "json", key: "headers", label: "Headers" },
+      { type: "expression", key: "payload", label: "Payload", required: true, example: "{{ $json }}" }
+    ]
+  },
+  // ───────────── Human ─────────────
+  {
+    name: "human_approval",
+    category: "human",
+    label: "Human Approval",
+    description: "Pause until a human approves or denies.",
+    icon: "\u2713",
+    inputs: [{ id: "in" }],
+    outputs: [{ id: "approved", label: "approved" }, { id: "denied", label: "denied" }],
+    configSchema: [
+      { type: "text", key: "title", label: "Approval title", default: "Approve action" },
+      { type: "textarea", key: "description", label: "Description for approver", rows: 3 },
+      { type: "credential", key: "channel", label: "Notify channel", credentialType: "notify_channel" }
+    ]
+  },
+  {
+    name: "notify",
+    category: "human",
+    label: "Notify",
+    description: "Send a message via Slack / email / SMS / etc.",
+    icon: "\u{1F514}",
+    configSchema: [
+      {
+        type: "select",
+        key: "channel",
+        label: "Channel",
+        default: "slack",
+        options: [
+          { value: "slack", label: "Slack" },
+          { value: "email", label: "Email" },
+          { value: "sms", label: "SMS" },
+          { value: "discord", label: "Discord" }
+        ]
+      },
+      { type: "text", key: "to", label: "To", required: true },
+      { type: "expression", key: "message", label: "Message", required: true, example: "{{ $json.summary }}" }
+    ]
+  },
+  // ───────────── Output ─────────────
+  {
+    name: "output",
+    category: "output",
+    label: "Output",
+    description: "Terminal node \u2014 captures the workflow's result.",
+    icon: "\u25CF",
+    inputs: [{ id: "in" }],
+    outputs: []
+  },
+  {
+    name: "log",
+    category: "output",
+    label: "Log",
+    description: "Send to the run feed.",
+    icon: "\u2261",
+    inputs: [{ id: "in" }],
+    outputs: [],
+    configSchema: [
+      {
+        type: "select",
+        key: "level",
+        label: "Level",
+        default: "info",
+        options: [{ value: "info", label: "info" }, { value: "warn", label: "warn" }, { value: "error", label: "error" }]
+      },
+      { type: "expression", key: "message", label: "Message", required: true, example: "{{ $json }}" }
+    ]
+  }
+];
+function registerBuiltinKinds() {
+  for (const k of KINDS) registerNodeKind(k);
+}
+var BUILTIN_KINDS = KINDS;
+
+// src/registry/index.ts
+function buildNodeTypes() {
+  const map = {};
+  for (const k of listNodeKinds()) map[k.name] = RegistryNode;
+  return map;
+}
+
+exports.BUILTIN_KINDS = BUILTIN_KINDS;
+exports.RegistryNode = RegistryNode;
+exports.buildNodeTypes = buildNodeTypes;
+exports.categoryAccent = categoryAccent;
+exports.defaultConfigFor = defaultConfigFor;
+exports.getNodeKind = getNodeKind;
+exports.listNodeKinds = listNodeKinds;
+exports.onNodeKindsChanged = onNodeKindsChanged;
+exports.registerBuiltinKinds = registerBuiltinKinds;
+exports.registerNodeKind = registerNodeKind;
+exports.validateConfig = validateConfig;
+//# sourceMappingURL=registry.cjs.map
+//# sourceMappingURL=registry.cjs.map