@gravito/flux 3.0.0 → 3.0.2

package/dist/chunk-WGDTB6OC.js

@@ -0,0 +1,316 @@
+// src/visualization/MermaidGenerator.ts
+var MermaidGenerator = class {
+  /**
+   * Generates a Mermaid flowchart from a workflow definition.
+   *
+   * @param definition - The workflow definition to visualize
+   * @param options - Customization options
+   * @returns Mermaid diagram syntax as a string
+   *
+   * @example
+   * ```typescript
+   * const generator = new MermaidGenerator()
+   * const diagram = generator.generateFromDefinition(workflow, {
+   *   showDetails: true,
+   *   showParallelGroups: true
+   * })
+   * console.log(diagram)
+   * ```
+   */
+  generateFromDefinition(definition, options = {}) {
+    const { showDetails = false, showParallelGroups = true, theme = "default" } = options;
+    const lines = [];
+    lines.push(`%%{init: {'theme':'${theme}'}}%%`);
+    lines.push("flowchart TD");
+    lines.push(`  Start([Start: ${definition.name}])`);
+    let prevNode = "Start";
+    const parallelGroups = /* @__PURE__ */ new Map();
+    if (showParallelGroups) {
+      for (const step of definition.steps) {
+        if (step.parallelGroup) {
+          const group = parallelGroups.get(step.parallelGroup) || [];
+          group.push(step.name);
+          parallelGroups.set(step.parallelGroup, group);
+        }
+      }
+    }
+    const processedGroups = /* @__PURE__ */ new Set();
+    for (let i = 0; i < definition.steps.length; i++) {
+      const step = definition.steps[i];
+      if (step.parallelGroup && showParallelGroups) {
+        if (processedGroups.has(step.parallelGroup)) {
+          continue;
+        }
+        processedGroups.add(step.parallelGroup);
+        const groupSteps = parallelGroups.get(step.parallelGroup);
+        const groupName = `ParallelGroup_${step.parallelGroup}`;
+        lines.push(`  subgraph ${groupName}[" "]`);
+        lines.push(`    direction LR`);
+        for (const stepName of groupSteps) {
+          const s = definition.steps.find((st) => st.name === stepName);
+          const nodeId = this.sanitizeNodeId(stepName);
+          const label = this.buildStepLabel(s, showDetails);
+          const shape = s.commit ? `[${label}]` : `(${label})`;
+          lines.push(`    ${nodeId}${shape}`);
+          if (s.compensate) {
+            lines.push(`    ${nodeId}_comp[\u{1F504} Compensate]`);
+            lines.push(`    ${nodeId} -.->|on failure| ${nodeId}_comp`);
+          }
+        }
+        lines.push(`  end`);
+        lines.push(`  ${prevNode} --> ${groupName}`);
+        prevNode = groupName;
+      } else if (!step.parallelGroup) {
+        const nodeId = this.sanitizeNodeId(step.name);
+        const label = this.buildStepLabel(step, showDetails);
+        const shape = step.commit ? `[${label}]` : `(${label})`;
+        lines.push(`  ${nodeId}${shape}`);
+        if (step.when) {
+          const condId = `${nodeId}_cond`;
+          lines.push(`  ${condId}{Condition?}`);
+          lines.push(`  ${prevNode} --> ${condId}`);
+          lines.push(`  ${condId} -->|yes| ${nodeId}`);
+          lines.push(`  ${condId} -->|no| ${this.getNextNodeId(definition.steps, i)}`);
+          prevNode = nodeId;
+        } else {
+          lines.push(`  ${prevNode} --> ${nodeId}`);
+          prevNode = nodeId;
+        }
+        if (step.compensate) {
+          lines.push(`  ${nodeId}_comp[\u{1F504} Compensate]`);
+          lines.push(`  ${nodeId} -.->|on failure| ${nodeId}_comp`);
+        }
+      }
+    }
+    lines.push(`  ${prevNode} --> End([End])`);
+    lines.push("");
+    lines.push("  classDef commitStep fill:#e1f5e1,stroke:#4caf50,stroke-width:2px");
+    lines.push("  classDef normalStep fill:#e3f2fd,stroke:#2196f3,stroke-width:2px");
+    lines.push(
+      "  classDef compensateStep fill:#fff3e0,stroke:#ff9800,stroke-width:1px,stroke-dasharray: 5 5"
+    );
+    return lines.join("\n");
+  }
+  /**
+   * Generates a Mermaid flowchart from a workflow execution state.
+   * Overlays execution status (completed, failed, compensated) on top of the structure.
+   *
+   * @param definition - The workflow definition
+   * @param state - The current execution state
+   * @param options - Customization options
+   * @returns Mermaid diagram syntax with status overlay
+   *
+   * @example
+   * ```typescript
+   * const diagram = generator.generateFromState(workflow, executionState, {
+   *   showStatus: true,
+   *   showDetails: true
+   * })
+   * ```
+   */
+  generateFromState(definition, state, options = {}) {
+    const {
+      showDetails = true,
+      showStatus = true,
+      showParallelGroups = true,
+      theme = "default"
+    } = options;
+    const lines = [];
+    lines.push(`%%{init: {'theme':'${theme}'}}%%`);
+    lines.push("flowchart TD");
+    lines.push(`  Start([Start: ${definition.name}])`);
+    lines.push(`  Start:::started`);
+    let prevNode = "Start";
+    const parallelGroups = /* @__PURE__ */ new Map();
+    const executionMap = /* @__PURE__ */ new Map();
+    for (const exec of state.history) {
+      executionMap.set(exec.name, exec);
+    }
+    if (showParallelGroups) {
+      for (const step of definition.steps) {
+        if (step.parallelGroup) {
+          const group = parallelGroups.get(step.parallelGroup) || [];
+          group.push(step.name);
+          parallelGroups.set(step.parallelGroup, group);
+        }
+      }
+    }
+    const processedGroups = /* @__PURE__ */ new Set();
+    for (let i = 0; i < definition.steps.length; i++) {
+      const step = definition.steps[i];
+      if (step.parallelGroup && showParallelGroups) {
+        if (processedGroups.has(step.parallelGroup)) {
+          continue;
+        }
+        processedGroups.add(step.parallelGroup);
+        const groupSteps = parallelGroups.get(step.parallelGroup);
+        const groupName = `ParallelGroup_${step.parallelGroup}`;
+        lines.push(`  subgraph ${groupName}[" "]`);
+        lines.push(`    direction LR`);
+        for (const stepName of groupSteps) {
+          const s = definition.steps.find((st) => st.name === stepName);
+          const nodeId = this.sanitizeNodeId(stepName);
+          const exec = executionMap.get(stepName);
+          const label = this.buildStepLabelWithStatus(s, exec, showDetails, showStatus);
+          const shape = s.commit ? `[${label}]` : `(${label})`;
+          lines.push(`    ${nodeId}${shape}`);
+          if (exec && showStatus) {
+            const statusClass = this.getStatusClass(exec.status);
+            lines.push(`    ${nodeId}:::${statusClass}`);
+          }
+          if (s.compensate && exec?.status === "compensated") {
+            lines.push(`    ${nodeId}_comp[\u{1F504} Compensated]`);
+            lines.push(`    ${nodeId}_comp:::compensated`);
+            lines.push(`    ${nodeId} -.->|rolled back| ${nodeId}_comp`);
+          }
+        }
+        lines.push(`  end`);
+        lines.push(`  ${prevNode} --> ${groupName}`);
+        prevNode = groupName;
+      } else if (!step.parallelGroup) {
+        const nodeId = this.sanitizeNodeId(step.name);
+        const exec = executionMap.get(step.name);
+        const label = this.buildStepLabelWithStatus(step, exec, showDetails, showStatus);
+        const shape = step.commit ? `[${label}]` : `(${label})`;
+        lines.push(`  ${nodeId}${shape}`);
+        if (exec && showStatus) {
+          const statusClass = this.getStatusClass(exec.status);
+          lines.push(`  ${nodeId}:::${statusClass}`);
+        }
+        if (step.when) {
+          const condId = `${nodeId}_cond`;
+          const skipped = exec?.status === "skipped";
+          lines.push(`  ${condId}{Condition?}`);
+          lines.push(`  ${prevNode} --> ${condId}`);
+          if (skipped) {
+            lines.push(`  ${condId}:::skipped`);
+            lines.push(`  ${condId} -->|no| ${nodeId}`);
+          } else {
+            lines.push(`  ${condId} -->|yes| ${nodeId}`);
+          }
+        } else {
+          lines.push(`  ${prevNode} --> ${nodeId}`);
+        }
+        if (step.compensate && exec?.status === "compensated") {
+          lines.push(`  ${nodeId}_comp[\u{1F504} Compensated]`);
+          lines.push(`  ${nodeId}_comp:::compensated`);
+          lines.push(`  ${nodeId} -.->|rolled back| ${nodeId}_comp`);
+        }
+        prevNode = nodeId;
+      }
+    }
+    const finalStatus = this.getWorkflowFinalStatus(state.status);
+    lines.push(`  ${prevNode} --> End([End: ${finalStatus}])`);
+    lines.push(`  End:::${this.getStatusClass(state.status)}`);
+    lines.push("");
+    lines.push("  classDef started fill:#e3f2fd,stroke:#2196f3,stroke-width:2px");
+    lines.push("  classDef completed fill:#e8f5e9,stroke:#4caf50,stroke-width:2px");
+    lines.push("  classDef failed fill:#ffebee,stroke:#f44336,stroke-width:2px");
+    lines.push("  classDef compensated fill:#fff3e0,stroke:#ff9800,stroke-width:2px");
+    lines.push(
+      "  classDef skipped fill:#f5f5f5,stroke:#9e9e9e,stroke-width:1px,stroke-dasharray: 5 5"
+    );
+    lines.push("  classDef pending fill:#fafafa,stroke:#bdbdbd,stroke-width:1px");
+    lines.push(
+      "  classDef suspended fill:#e1f5fe,stroke:#03a9f4,stroke-width:2px,stroke-dasharray: 3 3"
+    );
+    return lines.join("\n");
+  }
+  sanitizeNodeId(name) {
+    return name.replace(/[^a-zA-Z0-9_]/g, "_");
+  }
+  buildStepLabel(step, showDetails) {
+    let label = step.name;
+    if (showDetails) {
+      const meta = [];
+      if (step.commit) {
+        meta.push("\u{1F4DD}");
+      }
+      if (step.retries && step.retries > 0) {
+        meta.push(`\u21BB${step.retries}`);
+      }
+      if (step.timeout) {
+        meta.push(`\u23F1${step.timeout}ms`);
+      }
+      if (step.when) {
+        meta.push("\u2753");
+      }
+      if (meta.length > 0) {
+        label += `<br/><small>${meta.join(" ")}</small>`;
+      }
+    }
+    return label;
+  }
+  buildStepLabelWithStatus(step, exec, showDetails, showStatus) {
+    let label = step.name;
+    if (showStatus && exec) {
+      label += `<br/><small><b>${exec.status.toUpperCase()}</b></small>`;
+      if (exec.duration) {
+        label += `<br/><small>${exec.duration}ms</small>`;
+      }
+      if (exec.retries > 0) {
+        label += `<br/><small>Retries: ${exec.retries}</small>`;
+      }
+    } else if (showDetails) {
+      const meta = [];
+      if (step.commit) {
+        meta.push("\u{1F4DD}");
+      }
+      if (step.retries && step.retries > 0) {
+        meta.push(`\u21BB${step.retries}`);
+      }
+      if (step.timeout) {
+        meta.push(`\u23F1${step.timeout}ms`);
+      }
+      if (step.when) {
+        meta.push("\u2753");
+      }
+      if (meta.length > 0) {
+        label += `<br/><small>${meta.join(" ")}</small>`;
+      }
+    }
+    return label;
+  }
+  getStatusClass(status) {
+    switch (status) {
+      case "completed":
+        return "completed";
+      case "failed":
+        return "failed";
+      case "compensated":
+      case "compensating":
+        return "compensated";
+      case "skipped":
+        return "skipped";
+      case "suspended":
+        return "suspended";
+      case "running":
+        return "started";
+      default:
+        return "pending";
+    }
+  }
+  getWorkflowFinalStatus(status) {
+    switch (status) {
+      case "completed":
+        return "\u2705 Completed";
+      case "failed":
+        return "\u274C Failed";
+      case "rolled_back":
+        return "\u{1F504} Rolled Back";
+      case "suspended":
+        return "\u23F8 Suspended";
+      default:
+        return status;
+    }
+  }
+  getNextNodeId(steps, currentIndex) {
+    const nextStep = steps[currentIndex + 1];
+    return nextStep ? this.sanitizeNodeId(nextStep.name) : "End";
+  }
+};
+
+export {
+  MermaidGenerator
+};
+//# sourceMappingURL=chunk-WGDTB6OC.js.map

package/dist/chunk-WGDTB6OC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/visualization/MermaidGenerator.ts"],"sourcesContent":["import type { StepExecution, WorkflowDefinition, WorkflowState } from '../types'\n\n/**\n * Options for customizing Mermaid diagram generation.\n */\nexport interface MermaidOptions {\n  /** Include detailed step information (retries, timeout, conditions). */\n  showDetails?: boolean\n  /** Include execution history with status colors. */\n  showStatus?: boolean\n  /** Render parallel groups visually. */\n  showParallelGroups?: boolean\n  /** Theme: 'default' | 'dark' | 'forest' | 'neutral'. */\n  theme?: 'default' | 'dark' | 'forest' | 'neutral'\n}\n\n/**\n * Generates Mermaid flowchart diagrams from workflow definitions and execution states.\n *\n * **Features**:\n * - Workflow structure visualization (steps, parallel groups, conditions)\n * - Execution status overlay (completed, failed, compensated)\n * - Detailed metadata (retries, timeout, commit markers)\n *\n * **Use Cases**:\n * - Documentation generation\n * - Debugging workflow execution\n * - Visual workflow design validation\n */\nexport class MermaidGenerator {\n  /**\n   * Generates a Mermaid flowchart from a workflow definition.\n   *\n   * @param definition - The workflow definition to visualize\n   * @param options - Customization options\n   * @returns Mermaid diagram syntax as a string\n   *\n   * @example\n   * ```typescript\n   * const generator = new MermaidGenerator()\n   * const diagram = generator.generateFromDefinition(workflow, {\n   *   showDetails: true,\n   *   showParallelGroups: true\n   * })\n   * console.log(diagram)\n   * ```\n   */\n  generateFromDefinition<TInput, TData>(\n    definition: WorkflowDefinition<TInput, TData>,\n    options: MermaidOptions = {}\n  ): string {\n    const { showDetails = false, showParallelGroups = true, theme = 'default' } = options\n\n    const lines: string[] = []\n    lines.push(`%%{init: {'theme':'${theme}'}}%%`)\n    lines.push('flowchart TD')\n    lines.push(`  Start([Start: ${definition.name}])`)\n\n    let prevNode = 'Start'\n    const parallelGroups = new Map<string, string[]>()\n\n    // First pass: identify parallel groups\n    if (showParallelGroups) {\n      for (const step of definition.steps) {\n        if (step.parallelGroup) {\n          const group = parallelGroups.get(step.parallelGroup) || []\n          group.push(step.name)\n          parallelGroups.set(step.parallelGroup, group)\n        }\n      }\n    }\n\n    const processedGroups = new Set<string>()\n\n    for (let i = 0; i < definition.steps.length; i++) {\n      const step = definition.steps[i]!\n\n      // Handle parallel groups\n      if (step.parallelGroup && showParallelGroups) {\n        if (processedGroups.has(step.parallelGroup)) {\n          continue // Already processed this group\n        }\n        processedGroups.add(step.parallelGroup)\n\n        const groupSteps = parallelGroups.get(step.parallelGroup)!\n        const groupName = `ParallelGroup_${step.parallelGroup}`\n\n        // Create subgraph for parallel execution\n        lines.push(`  subgraph ${groupName}[\" \"]`)\n        lines.push(`    direction LR`)\n\n        for (const stepName of groupSteps) {\n          const s = definition.steps.find((st) => st.name === stepName)!\n          const nodeId = this.sanitizeNodeId(stepName)\n          const label = this.buildStepLabel(s, showDetails)\n          const shape = s.commit ? `[${label}]` : `(${label})`\n          lines.push(`    ${nodeId}${shape}`)\n\n          if (s.compensate) {\n            lines.push(`    ${nodeId}_comp[🔄 Compensate]`)\n            lines.push(`    ${nodeId} -.->|on failure| ${nodeId}_comp`)\n          }\n        }\n\n        lines.push(`  end`)\n        lines.push(`  ${prevNode} --> ${groupName}`)\n        prevNode = groupName\n      } else if (!step.parallelGroup) {\n        // Regular sequential step\n        const nodeId = this.sanitizeNodeId(step.name)\n        const label = this.buildStepLabel(step, showDetails)\n        const shape = step.commit ? `[${label}]` : `(${label})`\n\n        lines.push(`  ${nodeId}${shape}`)\n\n        // Handle conditional steps\n        if (step.when) {\n          const condId = `${nodeId}_cond`\n          lines.push(`  ${condId}{Condition?}`)\n          lines.push(`  ${prevNode} --> ${condId}`)\n          lines.push(`  ${condId} -->|yes| ${nodeId}`)\n          lines.push(`  ${condId} -->|no| ${this.getNextNodeId(definition.steps, i)}`)\n          prevNode = nodeId\n        } else {\n          lines.push(`  ${prevNode} --> ${nodeId}`)\n          prevNode = nodeId\n        }\n\n        // Show compensation\n        if (step.compensate) {\n          lines.push(`  ${nodeId}_comp[🔄 Compensate]`)\n          lines.push(`  ${nodeId} -.->|on failure| ${nodeId}_comp`)\n        }\n      }\n    }\n\n    lines.push(`  ${prevNode} --> End([End])`)\n\n    // Add styling\n    lines.push('')\n    lines.push('  classDef commitStep fill:#e1f5e1,stroke:#4caf50,stroke-width:2px')\n    lines.push('  classDef normalStep fill:#e3f2fd,stroke:#2196f3,stroke-width:2px')\n    lines.push(\n      '  classDef compensateStep fill:#fff3e0,stroke:#ff9800,stroke-width:1px,stroke-dasharray: 5 5'\n    )\n\n    return lines.join('\\n')\n  }\n\n  /**\n   * Generates a Mermaid flowchart from a workflow execution state.\n   * Overlays execution status (completed, failed, compensated) on top of the structure.\n   *\n   * @param definition - The workflow definition\n   * @param state - The current execution state\n   * @param options - Customization options\n   * @returns Mermaid diagram syntax with status overlay\n   *\n   * @example\n   * ```typescript\n   * const diagram = generator.generateFromState(workflow, executionState, {\n   *   showStatus: true,\n   *   showDetails: true\n   * })\n   * ```\n   */\n  generateFromState<TInput, TData>(\n    definition: WorkflowDefinition<TInput, TData>,\n    state: WorkflowState<TInput, TData>,\n    options: MermaidOptions = {}\n  ): string {\n    const {\n      showDetails = true,\n      showStatus = true,\n      showParallelGroups = true,\n      theme = 'default',\n    } = options\n\n    const lines: string[] = []\n    lines.push(`%%{init: {'theme':'${theme}'}}%%`)\n    lines.push('flowchart TD')\n    lines.push(`  Start([Start: ${definition.name}])`)\n    lines.push(`  Start:::started`)\n\n    let prevNode = 'Start'\n    const parallelGroups = new Map<string, string[]>()\n    const executionMap = new Map<string, StepExecution>()\n\n    // Build execution map\n    for (const exec of state.history) {\n      executionMap.set(exec.name, exec)\n    }\n\n    // Identify parallel groups\n    if (showParallelGroups) {\n      for (const step of definition.steps) {\n        if (step.parallelGroup) {\n          const group = parallelGroups.get(step.parallelGroup) || []\n          group.push(step.name)\n          parallelGroups.set(step.parallelGroup, group)\n        }\n      }\n    }\n\n    const processedGroups = new Set<string>()\n\n    for (let i = 0; i < definition.steps.length; i++) {\n      const step = definition.steps[i]!\n\n      // Handle parallel groups\n      if (step.parallelGroup && showParallelGroups) {\n        if (processedGroups.has(step.parallelGroup)) {\n          continue\n        }\n        processedGroups.add(step.parallelGroup)\n\n        const groupSteps = parallelGroups.get(step.parallelGroup)!\n        const groupName = `ParallelGroup_${step.parallelGroup}`\n\n        lines.push(`  subgraph ${groupName}[\" \"]`)\n        lines.push(`    direction LR`)\n\n        for (const stepName of groupSteps) {\n          const s = definition.steps.find((st) => st.name === stepName)!\n          const nodeId = this.sanitizeNodeId(stepName)\n          const exec = executionMap.get(stepName)\n          const label = this.buildStepLabelWithStatus(s, exec, showDetails, showStatus)\n          const shape = s.commit ? `[${label}]` : `(${label})`\n\n          lines.push(`    ${nodeId}${shape}`)\n\n          if (exec && showStatus) {\n            const statusClass = this.getStatusClass(exec.status)\n            lines.push(`    ${nodeId}:::${statusClass}`)\n          }\n\n          if (s.compensate && exec?.status === 'compensated') {\n            lines.push(`    ${nodeId}_comp[🔄 Compensated]`)\n            lines.push(`    ${nodeId}_comp:::compensated`)\n            lines.push(`    ${nodeId} -.->|rolled back| ${nodeId}_comp`)\n          }\n        }\n\n        lines.push(`  end`)\n        lines.push(`  ${prevNode} --> ${groupName}`)\n        prevNode = groupName\n      } else if (!step.parallelGroup) {\n        const nodeId = this.sanitizeNodeId(step.name)\n        const exec = executionMap.get(step.name)\n        const label = this.buildStepLabelWithStatus(step, exec, showDetails, showStatus)\n        const shape = step.commit ? `[${label}]` : `(${label})`\n\n        lines.push(`  ${nodeId}${shape}`)\n\n        if (exec && showStatus) {\n          const statusClass = this.getStatusClass(exec.status)\n          lines.push(`  ${nodeId}:::${statusClass}`)\n        }\n\n        if (step.when) {\n          const condId = `${nodeId}_cond`\n          const skipped = exec?.status === 'skipped'\n          lines.push(`  ${condId}{Condition?}`)\n          lines.push(`  ${prevNode} --> ${condId}`)\n\n          if (skipped) {\n            lines.push(`  ${condId}:::skipped`)\n            lines.push(`  ${condId} -->|no| ${nodeId}`)\n          } else {\n            lines.push(`  ${condId} -->|yes| ${nodeId}`)\n          }\n        } else {\n          lines.push(`  ${prevNode} --> ${nodeId}`)\n        }\n\n        if (step.compensate && exec?.status === 'compensated') {\n          lines.push(`  ${nodeId}_comp[🔄 Compensated]`)\n          lines.push(`  ${nodeId}_comp:::compensated`)\n          lines.push(`  ${nodeId} -.->|rolled back| ${nodeId}_comp`)\n        }\n\n        prevNode = nodeId\n      }\n    }\n\n    const finalStatus = this.getWorkflowFinalStatus(state.status)\n    lines.push(`  ${prevNode} --> End([End: ${finalStatus}])`)\n    lines.push(`  End:::${this.getStatusClass(state.status)}`)\n\n    // Add status-based styling\n    lines.push('')\n    lines.push('  classDef started fill:#e3f2fd,stroke:#2196f3,stroke-width:2px')\n    lines.push('  classDef completed fill:#e8f5e9,stroke:#4caf50,stroke-width:2px')\n    lines.push('  classDef failed fill:#ffebee,stroke:#f44336,stroke-width:2px')\n    lines.push('  classDef compensated fill:#fff3e0,stroke:#ff9800,stroke-width:2px')\n    lines.push(\n      '  classDef skipped fill:#f5f5f5,stroke:#9e9e9e,stroke-width:1px,stroke-dasharray: 5 5'\n    )\n    lines.push('  classDef pending fill:#fafafa,stroke:#bdbdbd,stroke-width:1px')\n    lines.push(\n      '  classDef suspended fill:#e1f5fe,stroke:#03a9f4,stroke-width:2px,stroke-dasharray: 3 3'\n    )\n\n    return lines.join('\\n')\n  }\n\n  private sanitizeNodeId(name: string): string {\n    return name.replace(/[^a-zA-Z0-9_]/g, '_')\n  }\n\n  private buildStepLabel(step: any, showDetails: boolean): string {\n    let label = step.name\n\n    if (showDetails) {\n      const meta: string[] = []\n      if (step.commit) {\n        meta.push('📝')\n      }\n      if (step.retries && step.retries > 0) {\n        meta.push(`↻${step.retries}`)\n      }\n      if (step.timeout) {\n        meta.push(`⏱${step.timeout}ms`)\n      }\n      if (step.when) {\n        meta.push('❓')\n      }\n\n      if (meta.length > 0) {\n        label += `<br/><small>${meta.join(' ')}</small>`\n      }\n    }\n\n    return label\n  }\n\n  private buildStepLabelWithStatus(\n    step: any,\n    exec: StepExecution | undefined,\n    showDetails: boolean,\n    showStatus: boolean\n  ): string {\n    let label = step.name\n\n    if (showStatus && exec) {\n      label += `<br/><small><b>${exec.status.toUpperCase()}</b></small>`\n\n      if (exec.duration) {\n        label += `<br/><small>${exec.duration}ms</small>`\n      }\n\n      if (exec.retries > 0) {\n        label += `<br/><small>Retries: ${exec.retries}</small>`\n      }\n    } else if (showDetails) {\n      const meta: string[] = []\n      if (step.commit) {\n        meta.push('📝')\n      }\n      if (step.retries && step.retries > 0) {\n        meta.push(`↻${step.retries}`)\n      }\n      if (step.timeout) {\n        meta.push(`⏱${step.timeout}ms`)\n      }\n      if (step.when) {\n        meta.push('❓')\n      }\n\n      if (meta.length > 0) {\n        label += `<br/><small>${meta.join(' ')}</small>`\n      }\n    }\n\n    return label\n  }\n\n  private getStatusClass(status: string): string {\n    switch (status) {\n      case 'completed':\n        return 'completed'\n      case 'failed':\n        return 'failed'\n      case 'compensated':\n      case 'compensating':\n        return 'compensated'\n      case 'skipped':\n        return 'skipped'\n      case 'suspended':\n        return 'suspended'\n      case 'running':\n        return 'started'\n      default:\n        return 'pending'\n    }\n  }\n\n  private getWorkflowFinalStatus(status: string): string {\n    switch (status) {\n      case 'completed':\n        return '✅ Completed'\n      case 'failed':\n        return '❌ Failed'\n      case 'rolled_back':\n        return '🔄 Rolled Back'\n      case 'suspended':\n        return '⏸ Suspended'\n      default:\n        return status\n    }\n  }\n\n  private getNextNodeId(steps: any[], currentIndex: number): string {\n    const nextStep = steps[currentIndex + 1]\n    return nextStep ? this.sanitizeNodeId(nextStep.name) : 'End'\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-SJSPR4ZU.cjs → chunk-YXBEYVGY.cjs}

@@ -4,12 +4,21 @@ var BunSQLiteStorage = (_class = class {
   
   
   __init() {this.initialized = false}
+  /**
+   * Creates a new instance of BunSQLiteStorage.
+   *
+   * @param options - Configuration for the database connection and table naming.
+   */
   constructor(options = {}) {;_class.prototype.__init.call(this);
     this.db = new (0, _bunsqlite.Database)(_nullishCoalesce(options.path, () => ( ":memory:")));
     this.tableName = _nullishCoalesce(options.tableName, () => ( "flux_workflows"));
   }
   /**
-   * Initialize storage (create tables)
+   * Initializes the database schema and required indexes.
+   *
+   * This method is idempotent and will be called automatically by other operations if not invoked manually.
+   *
+   * @throws {Error} If the database schema cannot be created or indexes fail to initialize.
    */
   async init() {
     if (this.initialized) {
@@ -27,7 +36,9 @@ var BunSQLiteStorage = (_class = class {
         error TEXT,
         created_at TEXT NOT NULL,
         updated_at TEXT NOT NULL,
-        completed_at TEXT
+        completed_at TEXT,
+        version INTEGER NOT NULL DEFAULT 1,
+        definition_version TEXT
       )
     `);
     this.db.run(`
@@ -45,14 +56,19 @@ var BunSQLiteStorage = (_class = class {
     this.initialized = true;
   }
   /**
-   * Save workflow state
+   * Persists or updates a workflow state in the database.
+   *
+   * Uses an "INSERT OR REPLACE" strategy to ensure the latest state is always stored for a given ID.
+   *
+   * @param state - The current state of the workflow to be saved.
+   * @throws {Error} If the database write operation fails or serialization errors occur.
    */
   async save(state) {
     await this.init();
     const stmt = this.db.prepare(`
       INSERT OR REPLACE INTO ${this.tableName} 
-      (id, name, status, input, data, current_step, history, error, created_at, updated_at, completed_at)
-      VALUES ($id, $name, $status, $input, $data, $currentStep, $history, $error, $createdAt, $updatedAt, $completedAt)
+      (id, name, status, input, data, current_step, history, error, created_at, updated_at, completed_at, version, definition_version)
+      VALUES ($id, $name, $status, $input, $data, $currentStep, $history, $error, $createdAt, $updatedAt, $completedAt, $version, $definitionVersion)
     `);
     stmt.run({
       $id: state.id,
@@ -65,11 +81,17 @@ var BunSQLiteStorage = (_class = class {
       $error: _nullishCoalesce(state.error, () => ( null)),
       $createdAt: state.createdAt.toISOString(),
       $updatedAt: state.updatedAt.toISOString(),
-      $completedAt: _nullishCoalesce(_optionalChain([state, 'access', _2 => _2.completedAt, 'optionalAccess', _3 => _3.toISOString, 'call', _4 => _4()]), () => ( null))
+      $completedAt: _nullishCoalesce(_optionalChain([state, 'access', _2 => _2.completedAt, 'optionalAccess', _3 => _3.toISOString, 'call', _4 => _4()]), () => ( null)),
+      $version: state.version,
+      $definitionVersion: _nullishCoalesce(state.definitionVersion, () => ( null))
     });
   }
   /**
-   * Load workflow state by ID
+   * Retrieves a workflow state by its unique identifier.
+   *
+   * @param id - The unique ID of the workflow to load.
+   * @returns The reconstructed workflow state, or null if no record is found.
+   * @throws {Error} If the database query fails or deserialization of stored JSON fails.
    */
   async load(id) {
     await this.init();
@@ -83,7 +105,13 @@ var BunSQLiteStorage = (_class = class {
     return this.rowToState(row);
   }
   /**
-   * List workflow states with optional filter
+   * Lists workflow states based on the provided filtering criteria.
+   *
+   * Results are returned in descending order of creation time.
+   *
+   * @param filter - Criteria for filtering and paginating the results.
+   * @returns An array of workflow states matching the filter.
+   * @throws {Error} If the database query fails.
    */
   async list(filter) {
     await this.init();
@@ -105,12 +133,16 @@ var BunSQLiteStorage = (_class = class {
         params.$status = filter.status;
       }
     }
+    if (_optionalChain([filter, 'optionalAccess', _7 => _7.version])) {
+      query += " AND definition_version = $version";
+      params.$version = filter.version;
+    }
     query += " ORDER BY created_at DESC";
-    if (_optionalChain([filter, 'optionalAccess', _7 => _7.limit])) {
+    if (_optionalChain([filter, 'optionalAccess', _8 => _8.limit])) {
       query += " LIMIT $limit";
       params.$limit = filter.limit;
     }
-    if (_optionalChain([filter, 'optionalAccess', _8 => _8.offset])) {
+    if (_optionalChain([filter, 'optionalAccess', _9 => _9.offset])) {
       query += " OFFSET $offset";
       params.$offset = filter.offset;
     }
@@ -119,7 +151,10 @@ var BunSQLiteStorage = (_class = class {
     return rows.map((row) => this.rowToState(row));
   }
   /**
-   * Delete workflow state
+   * Deletes a workflow state from the database.
+   *
+   * @param id - The unique ID of the workflow to delete.
+   * @throws {Error} If the database deletion fails.
    */
   async delete(id) {
     await this.init();
@@ -129,14 +164,20 @@ var BunSQLiteStorage = (_class = class {
     stmt.run({ $id: id });
   }
   /**
-   * Close database connection
+   * Closes the database connection and resets the initialization state.
+   *
+   * @throws {Error} If the database connection cannot be closed cleanly.
    */
   async close() {
     this.db.close();
     this.initialized = false;
   }
   /**
-   * Convert SQLite row to WorkflowState
+   * Converts a raw database row into a structured WorkflowState object.
+   *
+   * @param row - The raw SQLite row data.
+   * @returns The parsed workflow state.
+   * @private
    */
   rowToState(row) {
     return {
@@ -150,17 +191,25 @@ var BunSQLiteStorage = (_class = class {
       error: _nullishCoalesce(row.error, () => ( void 0)),
       createdAt: new Date(row.created_at),
       updatedAt: new Date(row.updated_at),
-      completedAt: row.completed_at ? new Date(row.completed_at) : void 0
+      completedAt: row.completed_at ? new Date(row.completed_at) : void 0,
+      version: row.version,
+      definitionVersion: _nullishCoalesce(row.definition_version, () => ( void 0))
     };
   }
   /**
-   * Get raw database (for advanced usage)
+   * Provides direct access to the underlying Bun SQLite Database instance.
+   *
+   * Useful for performing custom queries or maintenance tasks.
+   *
+   * @returns The raw Database instance.
    */
   getDatabase() {
     return this.db;
   }
   /**
-   * Run a vacuum to optimize database
+   * Performs a VACUUM operation to reclaim unused space and defragment the database.
+   *
+   * @throws {Error} If the VACUUM operation fails.
    */
   vacuum() {
     this.db.run("VACUUM");
@@ -170,4 +219,4 @@ var BunSQLiteStorage = (_class = class {
 
 
 exports.BunSQLiteStorage = BunSQLiteStorage;
-//# sourceMappingURL=chunk-SJSPR4ZU.cjs.map
+//# sourceMappingURL=chunk-YXBEYVGY.cjs.map

package/dist/chunk-YXBEYVGY.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/carl/Dev/Carl/gravito-core-ci-fix/packages/flux/dist/chunk-YXBEYVGY.cjs","../src/storage/BunSQLiteStorage.ts"],"names":[],"mappings":"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","file":"/Users/carl/Dev/Carl/gravito-core-ci-fix/packages/flux/dist/chunk-YXBEYVGY.cjs","sourcesContent":[null,"import { Database } from 'bun:sqlite'\nimport type { WorkflowFilter, WorkflowState, WorkflowStorage } from '../types'\n\n/**\n * Configuration options for the Bun SQLite storage adapter.\n */\nexport interface BunSQLiteStorageOptions {\n  /**\n   * Path to the SQLite database file.\n   * Use ':memory:' for an ephemeral in-memory database.\n   */\n  path?: string\n  /**\n   * Name of the table used to store workflow states.\n   */\n  tableName?: string\n}\n\n/**\n * BunSQLiteStorage provides a persistent storage backend for Flux workflows using Bun's native SQLite module.\n *\n * It handles automatic table creation, indexing for performance, and serialization of workflow state\n * into a relational format.\n *\n * @example\n * ```typescript\n * const storage = new BunSQLiteStorage({\n *   path: './workflows.db',\n *   tableName: 'my_workflows'\n * });\n * await storage.init();\n * ```\n */\nexport class BunSQLiteStorage implements WorkflowStorage {\n  private db: Database\n  private tableName: string\n  private initialized = false\n\n  /**\n   * Creates a new instance of BunSQLiteStorage.\n   *\n   * @param options - Configuration for the database connection and table naming.\n   */\n  constructor(options: BunSQLiteStorageOptions = {}) {\n    this.db = new Database(options.path ?? ':memory:')\n    this.tableName = options.tableName ?? 'flux_workflows'\n  }\n\n  /**\n   * Initializes the database schema and required indexes.\n   *\n   * This method is idempotent and will be called automatically by other operations if not invoked manually.\n   *\n   * @throws {Error} If the database schema cannot be created or indexes fail to initialize.\n   */\n  async init(): Promise<void> {\n    if (this.initialized) {\n      return\n    }\n\n    this.db.run(`\n      CREATE TABLE IF NOT EXISTS ${this.tableName} (\n        id TEXT PRIMARY KEY,\n        name TEXT NOT NULL,\n        status TEXT NOT NULL,\n        input TEXT NOT NULL,\n        data TEXT NOT NULL,\n        current_step INTEGER NOT NULL,\n        history TEXT NOT NULL,\n        error TEXT,\n        created_at TEXT NOT NULL,\n        updated_at TEXT NOT NULL,\n        completed_at TEXT,\n        version INTEGER NOT NULL DEFAULT 1,\n        definition_version TEXT\n      )\n    `)\n\n    this.db.run(`\n      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_name \n      ON ${this.tableName}(name)\n    `)\n    this.db.run(`\n      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_status \n      ON ${this.tableName}(status)\n    `)\n    this.db.run(`\n      CREATE INDEX IF NOT EXISTS idx_${this.tableName}_created \n      ON ${this.tableName}(created_at DESC)\n    `)\n\n    this.initialized = true\n  }\n\n  /**\n   * Persists or updates a workflow state in the database.\n   *\n   * Uses an \"INSERT OR REPLACE\" strategy to ensure the latest state is always stored for a given ID.\n   *\n   * @param state - The current state of the workflow to be saved.\n   * @throws {Error} If the database write operation fails or serialization errors occur.\n   */\n  async save(state: WorkflowState): Promise<void> {\n    await this.init()\n\n    const stmt = this.db.prepare(`\n      INSERT OR REPLACE INTO ${this.tableName} \n      (id, name, status, input, data, current_step, history, error, created_at, updated_at, completed_at, version, definition_version)\n      VALUES ($id, $name, $status, $input, $data, $currentStep, $history, $error, $createdAt, $updatedAt, $completedAt, $version, $definitionVersion)\n    `)\n\n    stmt.run({\n      $id: state.id,\n      $name: state.name,\n      $status: state.status,\n      $input: JSON.stringify(state.input),\n      $data: JSON.stringify(state.data),\n      $currentStep: state.currentStep,\n      $history: JSON.stringify(state.history),\n      $error: state.error ?? null,\n      $createdAt: state.createdAt.toISOString(),\n      $updatedAt: state.updatedAt.toISOString(),\n      $completedAt: state.completedAt?.toISOString() ?? null,\n      $version: state.version,\n      $definitionVersion: state.definitionVersion ?? null,\n    })\n  }\n\n  /**\n   * Retrieves a workflow state by its unique identifier.\n   *\n   * @param id - The unique ID of the workflow to load.\n   * @returns The reconstructed workflow state, or null if no record is found.\n   * @throws {Error} If the database query fails or deserialization of stored JSON fails.\n   */\n  async load(id: string): Promise<WorkflowState | null> {\n    await this.init()\n\n    const stmt = this.db.prepare(`\n      SELECT * FROM ${this.tableName} WHERE id = $id\n    `)\n\n    const row = stmt.get({ $id: id }) as SQLiteRow | null\n\n    if (!row) {\n      return null\n    }\n\n    return this.rowToState(row)\n  }\n\n  /**\n   * Lists workflow states based on the provided filtering criteria.\n   *\n   * Results are returned in descending order of creation time.\n   *\n   * @param filter - Criteria for filtering and paginating the results.\n   * @returns An array of workflow states matching the filter.\n   * @throws {Error} If the database query fails.\n   */\n  async list(filter?: WorkflowFilter): Promise<WorkflowState[]> {\n    await this.init()\n\n    let query = `SELECT * FROM ${this.tableName} WHERE 1=1`\n    const params: Record<string, unknown> = {}\n\n    if (filter?.name) {\n      query += ' AND name = $name'\n      params.$name = filter.name\n    }\n\n    if (filter?.status) {\n      if (Array.isArray(filter.status)) {\n        const placeholders = filter.status.map((_, i) => `$status${i}`).join(', ')\n        query += ` AND status IN (${placeholders})`\n        filter.status.forEach((s, i) => {\n          params[`$status${i}`] = s\n        })\n      } else {\n        query += ' AND status = $status'\n        params.$status = filter.status\n      }\n    }\n\n    if (filter?.version) {\n      query += ' AND definition_version = $version'\n      params.$version = filter.version\n    }\n\n    query += ' ORDER BY created_at DESC'\n\n    if (filter?.limit) {\n      query += ' LIMIT $limit'\n      params.$limit = filter.limit\n    }\n\n    if (filter?.offset) {\n      query += ' OFFSET $offset'\n      params.$offset = filter.offset\n    }\n\n    const stmt = this.db.prepare(query)\n    const rows = stmt.all(params as Record<string, any>) as SQLiteRow[]\n\n    return rows.map((row) => this.rowToState(row))\n  }\n\n  /**\n   * Deletes a workflow state from the database.\n   *\n   * @param id - The unique ID of the workflow to delete.\n   * @throws {Error} If the database deletion fails.\n   */\n  async delete(id: string): Promise<void> {\n    await this.init()\n\n    const stmt = this.db.prepare(`\n      DELETE FROM ${this.tableName} WHERE id = $id\n    `)\n\n    stmt.run({ $id: id })\n  }\n\n  /**\n   * Closes the database connection and resets the initialization state.\n   *\n   * @throws {Error} If the database connection cannot be closed cleanly.\n   */\n  async close(): Promise<void> {\n    this.db.close()\n    this.initialized = false\n  }\n\n  /**\n   * Converts a raw database row into a structured WorkflowState object.\n   *\n   * @param row - The raw SQLite row data.\n   * @returns The parsed workflow state.\n   * @private\n   */\n  private rowToState(row: SQLiteRow): WorkflowState {\n    return {\n      id: row.id,\n      name: row.name,\n      status: row.status as WorkflowState['status'],\n      input: JSON.parse(row.input),\n      data: JSON.parse(row.data),\n      currentStep: row.current_step,\n      history: JSON.parse(row.history),\n      error: row.error ?? undefined,\n      createdAt: new Date(row.created_at),\n      updatedAt: new Date(row.updated_at),\n      completedAt: row.completed_at ? new Date(row.completed_at) : undefined,\n      version: row.version,\n      definitionVersion: row.definition_version ?? undefined,\n    }\n  }\n\n  /**\n   * Provides direct access to the underlying Bun SQLite Database instance.\n   *\n   * Useful for performing custom queries or maintenance tasks.\n   *\n   * @returns The raw Database instance.\n   */\n  getDatabase(): Database {\n    return this.db\n  }\n\n  /**\n   * Performs a VACUUM operation to reclaim unused space and defragment the database.\n   *\n   * @throws {Error} If the VACUUM operation fails.\n   */\n  vacuum(): void {\n    this.db.run('VACUUM')\n  }\n}\n\n/**\n * Internal representation of a workflow record in the SQLite database.\n */\ninterface SQLiteRow {\n  id: string\n  name: string\n  status: string\n  input: string\n  data: string\n  current_step: number\n  history: string\n  error: string | null\n  created_at: string\n  updated_at: string\n  completed_at: string | null\n  version: number\n  definition_version: string | null\n}\n"]}