@particle-academy/fancy-flow 0.76.0 → 0.77.1

package/dist/ux.js

@@ -1,4 +1,4 @@
-import { registerNodeKind } from './chunk-V2657EQG.js';
+import { registerNodeKind } from './chunk-EEIWAIXW.js';
 import './chunk-2QXKDLGT.js';
 import { useMemo } from 'react';
 import { createEffectDispatcher } from '@particle-academy/fancy-auto-common';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@particle-academy/fancy-flow",
-  "version": "0.76.0",
+  "version": "0.77.1",
   "description": "Workflow editor + runner. Six built-in node kits (trigger / action / decision / output / note / subgraph), tokenized theme, topological execution with per-node status. React-flow bundled; consumers npm install fancy-flow and get nothing extra.",
   "repository": {
     "type": "git",

package/dist/chunk-UEOE6B52.js

@@ -1,39 +0,0 @@
-// src/registry/pause.ts
-var PAUSE_PREFIX = "fancy-flow:pause:";
-var LEGACY_PAUSE_PREFIXES = [
-  ["awaiting-approval:", "approval"],
-  ["awaiting-input:", "input"]
-];
-function encodePause(signal) {
-  const { nodeId, awaiting, detail } = signal;
-  return PAUSE_PREFIX + JSON.stringify(detail === void 0 ? { nodeId, awaiting } : { nodeId, awaiting, detail });
-}
-function decodePause(reason) {
-  if (typeof reason !== "string") return null;
-  if (reason.startsWith(PAUSE_PREFIX)) {
-    const body = reason.slice(PAUSE_PREFIX.length);
-    try {
-      const parsed = JSON.parse(body);
-      if (typeof parsed?.nodeId !== "string" || typeof parsed?.awaiting !== "string") return null;
-      return "detail" in parsed ? { nodeId: parsed.nodeId, awaiting: parsed.awaiting, detail: parsed.detail } : { nodeId: parsed.nodeId, awaiting: parsed.awaiting };
-    } catch {
-      return null;
-    }
-  }
-  for (const [prefix, awaiting] of LEGACY_PAUSE_PREFIXES) {
-    if (reason.startsWith(prefix)) {
-      return { nodeId: reason.slice(prefix.length), awaiting };
-    }
-  }
-  return null;
-}
-function isPause(reason) {
-  return decodePause(reason) !== null;
-}
-function pauseForHuman(ctx, awaiting, detail) {
-  return ctx.abort(encodePause({ nodeId: ctx.node.id, awaiting, detail }));
-}
-
-export { LEGACY_PAUSE_PREFIXES, PAUSE_PREFIX, decodePause, encodePause, isPause, pauseForHuman };
-//# sourceMappingURL=chunk-UEOE6B52.js.map
-//# sourceMappingURL=chunk-UEOE6B52.js.map

package/dist/chunk-UEOE6B52.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/registry/pause.ts"],"names":[],"mappings":";AA8CO,IAAM,YAAA,GAAe;AAUrB,IAAM,qBAAA,GAAyE;AAAA,EACpF,CAAC,sBAAsB,UAAU,CAAA;AAAA,EACjC,CAAC,mBAAmB,OAAO;AAC7B;AASO,SAAS,YAAY,MAAA,EAA6B;AACvD,EAAA,MAAM,EAAE,MAAA,EAAQ,QAAA,EAAU,MAAA,EAAO,GAAI,MAAA;AACrC,EAAA,OAAO,YAAA,GAAe,IAAA,CAAK,SAAA,CAAU,MAAA,KAAW,MAAA,GAAY,EAAE,MAAA,EAAQ,QAAA,EAAS,GAAI,EAAE,MAAA,EAAQ,QAAA,EAAU,QAAQ,CAAA;AACjH;AAUO,SAAS,YAAY,MAAA,EAAuD;AACjF,EAAA,IAAI,OAAO,MAAA,KAAW,QAAA,EAAU,OAAO,IAAA;AAEvC,EAAA,IAAI,MAAA,CAAO,UAAA,CAAW,YAAY,CAAA,EAAG;AACnC,IAAA,MAAM,IAAA,GAAO,MAAA,CAAO,KAAA,CAAM,YAAA,CAAa,MAAM,CAAA;AAC7C,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,IAAI,CAAA;AAG9B,MAAA,IAAI,OAAO,QAAQ,MAAA,KAAW,QAAA,IAAY,OAAO,MAAA,EAAQ,QAAA,KAAa,UAAU,OAAO,IAAA;AACvF,MAAA,OAAO,YAAY,MAAA,GACf,EAAE,QAAQ,MAAA,CAAO,MAAA,EAAQ,UAAU,MAAA,CAAO,QAAA,EAAU,QAAQ,MAAA,CAAO,MAAA,KACnE,EAAE,MAAA,EAAQ,OAAO,MAAA,EAAQ,QAAA,EAAU,OAAO,QAAA,EAAS;AAAA,IACzD,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,EACF;AAEA,EAAA,KAAA,MAAW,CAAC,MAAA,EAAQ,QAAQ,CAAA,IAAK,qBAAA,EAAuB;AACtD,IAAA,IAAI,MAAA,CAAO,UAAA,CAAW,MAAM,CAAA,EAAG;AAC7B,MAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,CAAO,MAAM,MAAA,CAAO,MAAM,GAAG,QAAA,EAAS;AAAA,IACzD;AAAA,EACF;AAEA,EAAA,OAAO,IAAA;AACT;AAGO,SAAS,QAAQ,MAAA,EAA4C;AAClE,EAAA,OAAO,WAAA,CAAY,MAAM,CAAA,KAAM,IAAA;AACjC;AAkBO,SAAS,aAAA,CACd,GAAA,EACA,QAAA,EACA,MAAA,EACO;AACP,EAAA,OAAO,GAAA,CAAI,KAAA,CAAM,WAAA,CAAY,EAAE,MAAA,EAAQ,GAAA,CAAI,IAAA,CAAK,EAAA,EAAI,QAAA,EAAU,MAAA,EAAQ,CAAC,CAAA;AACzE","file":"chunk-UEOE6B52.js","sourcesContent":["/**\n * The human-pause contract.\n *\n * A workflow that waits for a person is not an error, but it travels the same\n * channel as one: the executor aborts, the engine records a reason string, and\n * the durable runner decides whether that string meant \"failed\" or \"waiting\".\n *\n * That seam existed before this module, as two `str_starts_with` checks in the\n * Laravel run job against constants owned by two BUILTIN executors. It worked,\n * and it was invisible: a third-party human-input node had no way to announce\n * that it pauses, and nothing stopped a refactor from removing the mechanism\n * out from under published packages. Reported by the MOIC Suite consumer, who\n * needed exactly that and had to reach for a private constant to get it.\n *\n * So the encoding is now public, typed, and versioned by prefix rather than\n * implied. The wire format stays a plain string on purpose — it survives the\n * existing abort → `RunResult.error` path unchanged, crosses a queue boundary,\n * and decodes identically in PHP, none of which a thrown class would do.\n *\n * @see decodePause — the one function a durable runner needs.\n */\n\n/**\n * What the run is waiting for.\n *\n * `approval` and `input` are the shapes both runtimes ship. The type stays open\n * because the whole point is that a marketplace node can define its own —\n * a signature step, a payment confirmation, a review queue — and a runner that\n * does not recognise one should report it rather than guess.\n */\nexport type PauseAwaiting = \"approval\" | \"input\" | (string & {});\n\n/** A run halted, waiting for a person. */\nexport type PauseSignal = {\n  /** The node that paused — where a submission gets injected on resume. */\n  nodeId: string;\n  awaiting: PauseAwaiting;\n  /**\n   * Kind-supplied context for whoever renders the wait — a form schema, the\n   * question being asked, a diff to approve. Must be JSON-serializable: it\n   * crosses a queue boundary and, for durable runs, a database column.\n   */\n  detail?: unknown;\n};\n\n/** Marks a reason string as a pause rather than a failure. */\nexport const PAUSE_PREFIX = \"fancy-flow:pause:\";\n\n/**\n * Reason prefixes shipped before this contract, kept decodable forever.\n *\n * These are what `DurableApprovalExecutor` and `DurableUserInputExecutor`\n * emitted, and they are written into the `error` column of every run that\n * paused under an older version. Dropping them would strand those runs\n * mid-flight — a resume path that only works for new runs is not a resume path.\n */\nexport const LEGACY_PAUSE_PREFIXES: ReadonlyArray<readonly [string, PauseAwaiting]> = [\n  [\"awaiting-approval:\", \"approval\"],\n  [\"awaiting-input:\", \"input\"],\n];\n\n/**\n * Encode a pause as the reason string an executor aborts with.\n *\n * The payload is JSON rather than delimited fields because a node id may\n * contain a colon, and a positional encoding that breaks on user data is the\n * kind of bug that only shows up in someone else's graph.\n */\nexport function encodePause(signal: PauseSignal): string {\n  const { nodeId, awaiting, detail } = signal;\n  return PAUSE_PREFIX + JSON.stringify(detail === undefined ? { nodeId, awaiting } : { nodeId, awaiting, detail });\n}\n\n/**\n * Decode a run's error reason into a pause, or null if it was a real failure.\n *\n * This is the whole contract from a runner's side: call it on `result.error`,\n * and if it returns non-null, persist the run as waiting on `signal.nodeId`\n * instead of failing it. Accepts the legacy prefixes, so a runner written\n * against this handles runs that paused under an older version.\n */\nexport function decodePause(reason: string | null | undefined): PauseSignal | null {\n  if (typeof reason !== \"string\") return null;\n\n  if (reason.startsWith(PAUSE_PREFIX)) {\n    const body = reason.slice(PAUSE_PREFIX.length);\n    try {\n      const parsed = JSON.parse(body) as Partial<PauseSignal>;\n      // A malformed payload is a corrupt pause, not a failure to report as a\n      // crash — but it is also not something to invent a node id for.\n      if (typeof parsed?.nodeId !== \"string\" || typeof parsed?.awaiting !== \"string\") return null;\n      return \"detail\" in parsed\n        ? { nodeId: parsed.nodeId, awaiting: parsed.awaiting, detail: parsed.detail }\n        : { nodeId: parsed.nodeId, awaiting: parsed.awaiting };\n    } catch {\n      return null;\n    }\n  }\n\n  for (const [prefix, awaiting] of LEGACY_PAUSE_PREFIXES) {\n    if (reason.startsWith(prefix)) {\n      return { nodeId: reason.slice(prefix.length), awaiting };\n    }\n  }\n\n  return null;\n}\n\n/** True when a run's error reason is actually a pause. */\nexport function isPause(reason: string | null | undefined): boolean {\n  return decodePause(reason) !== null;\n}\n\n/**\n * Abort the current node as a pause.\n *\n * Called from inside an executor with its own context. Node authors should\n * reach for this rather than hand-encoding a reason, so the format stays ours\n * to change:\n *\n * ```ts\n * const values = ctx.inputs.values;\n * if (values === undefined) pauseForHuman(ctx, \"input\", { fields });\n * return values;\n * ```\n *\n * Note the `undefined` check — an empty submission (`{}`) is a real answer and\n * must resume. Truthiness here pauses forever on an empty form.\n */\nexport function pauseForHuman(\n  ctx: { node: { id: string }; abort: (reason?: string) => never },\n  awaiting: PauseAwaiting,\n  detail?: unknown,\n): never {\n  return ctx.abort(encodePause({ nodeId: ctx.node.id, awaiting, detail }));\n}\n"]}